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Abstract 


Perhaps  the  most  valuable  method  of  learning  is  through  experience. 
Tii is  report  presents  a  course  project  in  operating  systems  involving 
the  design  and  implementation  of  a  "toy"  operating  system.  The  first 
part  of  the  report  gives  the  complete  description  of  the  project  as 
well  as  an  example.  The  second  part  of  the  report  gives  a  manual  for  the 
implementation  language,  TOPPS  -  a  language  which  provides  basic  sychron- 
ization  primitives. 
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1  *  Introduction 

In  a  course  on  operating  systems  students  learn 
principles  and  basic  techniques.  Examples  and  exercises  help 
them  to  understand  how  these  techniques  can  be  applied 
practically.  Unfortunately,  lectures  are  not  enough.  For  a 
student  to  appreciate  some  of  the  problems,  he  has  to  face 
them  himself.  When  he  realizes  the  true  importance  of  a 
problem,  then  he  will  frantically  absorb  the  pertinent 
material.  True  knowledge  comes  when  somebody  needs  it.  One 
purpose  of  an  assignment  like  a  11  toy”  operating  system  is  to 
force  the  student  to  face  some  of  the  realities  of  software 
design . 

In  constructing  the  system,  the  students  are 
organized  into  teams  of  two  or  three.  Coordinating  their 
efforts  in  a  software  design  project  is  an  experience  in 
itself.  In  an  undergraduate  computer  science  curriculum, 
students  write  many  programs,  but  they  are  usually  ”toy” 
programs  which  can  be  written  without  any  discipline.  A 
ntoy”  operating  system  is  by  no  means  a  ”tov”  program.  It 
is  an  intricate  program  which  must  be  designed,  implemented 
and  tested  in  an  organized  manner.  A  student  has  no  hope  of 
sitting  in  front  of  a  piece  of  paper  and  getting  all  the 
ideas  in  a  single  lightning  stroke.  Nor  can  he  design  an 
operating  system,  even  a  "toy”  one,  without  really 
understanding  much  of  the  material  taught  in  the  course. 

However,  in  giving  students  practical  experience  in 
operating  systems,  a  major  problem  is  the  cost.  They  cannot 
be  allowed  to  tamper  with  the  production  operating  system  of 
the  university.  It  is  too  costly  in  terms  of  money  and  can 
degrade  the  service  provided  to  other  users.  Therefore,  an 
environment  has  to  be  generated  which  simulates  many  of  the 
problems  of  an  operating  system.  At  least  one  such  system 
has  been  documented  in  the  literature^.  The  system  used  at 
the  University  of  Toronto  is  based  on  a  simulated  machine. 
The  machine  is  called  000/Z  and  it  is  written  in  TOPPS,  a 
language  which  provides  parallel  processes  and  basic 
synchronization  primitives.  In  the  following  sections,  the 
000/Z  hardware  is  defined  and  the  steps  necessary  to  write  a 
000/Z  operating  system  are  given. 

The  purpose  of  the  000/Z  project  is  for  groups  of 
two  to  three  students  to  design  and  to  implement  an 
operating  system  for  the  hypothetical  000/Z  computer.  The 
system  is  to  be  written  in  TOPPS. 


Shaw,  A.  C.  and  N.  H.  Weiderman,  ”A  Multiprogramming 
System  for  Education  and  Research”,  Efoceedings  IFIP 
s2.tL3.Ff.ss  1.221/  Booklet  TA-7,  pp.  110-1  14. 
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The  hardware  for  000/z  consists  of  a  reader,  a 
printer,  a  drum  and  a  CPU  (with  core  memory) .  It  is 
simulated  by  TOPPS  programs  which  are  provided  (see 
Appendices  B  and  F)  .  These  programs  constitute  an  exact 
specification  of  the  hardware, 

.A  translator  written  in  TOPPS  is  also  provided. 
Programs  written  in  a  very  simple  "user  language”  are 
translated  into  the  000/Z  machine  code  for  execution  by  the 
CPU. 

Students  are  to  write  the  remaining  software:  an 
inspooler,  an  outspooler,  and  an  executive  program.  The 
inspooler  is  used  to  spool  an  input  stream  of  jobs,  written 
in  the  user  language,  onto  the  drum.  The  executive  program 
then  brings  jobs  from  drum  into  main  memory  where  they  will 
be  multi  programmed.  The  outspooler  prints  completed  jobs  by 
using  the  printer. 

The  first  part  of  the  report  contains  seven 
sections.  The  second  describes  the  000/Z  hardware.  The 
method  of  communication  with  the  various  hardware  devices  is 
explained.  Section  three  presents  a  description  of  the 
syntax  and  of  the  semantics  of  the  "user  language”  as  well 
as  the  program  format.  Section  four  contains  a  brief 
description  of  the  translator  so  that  the  user  may 
understand  its  Interface  with  the  system.  Section  five 
describes  a  simple  example  operating  system,  while  the  next 
section  provides  some  information  for  writing  a  more  complex 
system.  Section  seven  consists  of  five  appendices,  namely: 

(A)  JCL  for  Running  000/Z 

(B)  Subprograms  and  Programs  Provided 

(C)  Experience  with  000/Z  and  TOPPS. 

(D)  CPU  Instructions  and  Semantics 

(E)  Source  Code  of  an  Example  System 

The  000/Z  "toy”  operating  system  project  gives 
students  an  opportunity  for  practical  design  experience. 
Students  become  familiar  with  the  different  resources 
available  in  a  system  and  their  allocation  schemes. 
However,  there  are  problems  of  logistics  in  running  such  a 
project. 

The  first  problem  is  cost.  Each  team  of  students 
can  use  up  to  20  minutes  of  270/165  time  for  the  completion 
of  the  project.  The  reader  can  extrapolate  this  cost  to  his 
own  machine.  By  most  standards  this  is  rather  expensive. 
Costs  can  be  reduced  somewhat  by  simplifying  the  system. 
Another  alternative  could  be  to  limit  the  amount  of 
computing  time  each  team  may  spend.  In  any  case 
experimenting  with  operating  systems  cannot  be  very  cheap. 
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,  000 /Z  HARD WAR  E 


A  CPU,  READER,  PRINTER  and  DRUM 
system  are  provided.  They  are  simulated 
programs  and  subprograms  (see  Appendices 
memory  and  drum  storage  are  implemented  as 


for  the  000/Z 
through  TOPPS 
B  and  E)  .  Tore 
TOPPS  arrays. 


These  too  are  already  declared  for  the  student.  The 
following  discussion  is  not  intended  to  present  a  full 
description  of  each  hardware  device.  That  is  given  by  the 
program  listings.  The  primary  aim  of  this  section  is  to 
give  the  student  enough  information  so  that  his  operating 
system  may  interface  properly  with  the  various  hardware 


devices. 


2.1  MEMORY 


All  operations  on  MEMORY  are  transparent  to  the 
operating  system  except  for  the  handling  of  I/O  traps. 
Normally  MEMORY  is  manipulated  only  by  the  hardware.  The 
000/Z  memory  is  implemented  as  a  TOPPS  array,  MEMORY, 
containing  750  locations.  Each  location  may  hold  a  ne  number 
or  one  character. 

Numbers  and  characters  are  not  distinguished 
internally.  Therefore  the  reader  and  printer  must  translate 
between  internal  form  and  printed  or  punched  characters. 
The  internal  representation  of  any  character  is  the 
following : 

230  +  EBCDIC  code  for  the  character. 

This  translation  is  done  because  of  the  limitation  in  TOPPS 
on  the  number  of  <string>’s  that  can  be  used. 

2.2  EPU 


The  CPU  is  supplied.  It  Is  implemented  as  a  TOPPS 
subprogram.  MEMORY  is  used  both  for  programs  and  for  a  data 
stack*  The  following  variables  are  local  data  passed  to  the 
CPU,  namely: 


PRO G  JRAM  _BAS E :  absolute  location  In  MEMORY  of  the 

first  instruction  of  the  program 
which  is  currently  executing 

PROG RAM _SIZE :  size  of  the  program  in  MEMORY 

currently  executing 


IC: 


location  relative  to  PR0GRAM_3ASS  of 
the  next  instruction 


D  AT A  BASE: 


absolute  location  in  MEMORY  of  the 
first  word  of  the  data  stack. 
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!he  value  returned  by  the  subprogram  call  indicates 


CPU  are  to 
a  call  to 


the  cause  of  the  trap.  Traps  from  the 
by  the  operating  system.  The  format  of 

<trap>  :=  CPU  {PROGRAM  JBASE,  P30GRAM_SIZ 

DATABASE ,  D:\TA_SIZE,  STACKTOP, 
Below  are  given  the  trap  codes  and  their  meanings. 


os 
the 
IC, 
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hand  led 
CPU  is: 
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2 

3 

4 


U5AUING 

Attempt  to  execute  instruction  at  invalid 
location  {i.e.,  not  between  PRQGRAM_BA3E  and 
PROG  RAM  _ BAS  E  +  PROGRAHJSIZE)  . 

Stack  underflow  (i.e.,  attempt  to  pop  an  empty 
data  stack) . 

Stack  overflow. 

Store  violation  {i.e.,  attempt  to  store  out  of 
range  of  DATA_BA.SE  and  DATA_3ASE  +  DATA_SIZE  - 

1)  .  ' 


5  Fetch  violation  (i.e.,  attempt  to  access  data 
with  an  address  outside  of  the  data  area). 

6  Timer  Interrupt  (i.e.,  1  TIMER’  limit  of  number 
of  instructions  left  to  be  executed  has  been 
exceeded) . 

7  Division  by  zero. 

8  Invalid  opera tion . 

15  STOP  executed  and  program  reaches  normal 

ter  minat ion . 

16  GET  executed. 

1 7  PUT  executed . 

The  system  is  required  to  manipulate  MEMORY  in 

handling  I/O  traps  (GET  and  PUT  instructions) .  The  GET 
instruction  expects  the  operating  system  to  put  an  input 
item  onto  the  top  of  the  stack.  Accordingly,  the  stacktop 
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is  increase:! 

system  is  expected  to  store  the  item  at  location. 
M EMORY  { D AT A_ BASF  +  STACKTOP)  .  Similarly,  POT  decreases  the 
stacktop  by  1,  and  the  system  is  expected  to  print  the  item 
at  MEMORY  (DATA_BASE  +  STACKTOP  +  1)t  Roth  instructions  also 
increase  TC  to  continue  from  the  next  operation  in  the  event 
that  execution  resumes  after  handling  the  trap. 


2 . 3  FT^DER 

The  READER  is  implemented  as  a  TOPPS  program  which 
must  be  fired  up  in  the  main  process  written  by  the 
students.  Communication  between,  the  READER  and  the  rest  of 
the  system  is  accomplished  through  the  consumable  resources 
READER  START  and  READER  END. 


Commands  are  sent  to  it  by  the  resource 
R EADE RESTART .  For  each  command,  the  READER  reads  one  card 
and  places  its  contents  into  MEMORY  at  the  address  snecified 

l>  V. 

by  the  value  of  the  unit  of  resource  R SADEE_ START .  Three 

types  of  cards  are  recognized: 

(1)  Num9ric_data  --  the  first  column  is  a  digit.  The 

number  is  read  and  stored  in  one  MEMORY  location. 

(2)  Ch aracter _da t a  --  the  first  and  third  characters  are 

quotes.  The  character  between  is  converted  to 
internal  form  and  stored  in  MEMORY. 


(3)  Sonrce_Card  --  any  other  card.  The  first  twenty 
characters  are  converted  to  internal  form  and 
stored  in  twenty  consecutive  MEMORY  locations. 

tf  no  cards  remain  when  a  command  is  received,  the 
READER  stores  231-1.  This  is  used  as  an  end-of-file 
indication  throughout  the  system. 

The  READER  signals  that  it  has  completed  the 
operation  by  releasing  a  unit  of  the  resource  READSR_END. 


2 . 4  PRINTER 

The  printer  provided  is  a  TOPPS  program  and  must  be 
fired  up  in  the  main  process.  Communication  with  the  rest 
of  the  system  is  through  units  of  the  consumable  resources, 
PRINT ER_ START  and  PRI NTE R_END . 

Commands  are  sent  to  the  PRINTER  by  the  resource 
PRINT  ER_START .  The  address  and  number  of  items  to  be 
printed  are  packed  together  into  a  printer  command  with  the 
following  format: 

pio  *  <number>  +  <address>. 


. 

■  • 


. 

...  -  * 
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Th2  contents  of  the  specified  <number>  of  locations 


starting  from  the 

<address>  are  printed 

out . 

The 

printer 

recognizes  two  typ 

es  of'  contents: 

(1)  Numeric  -- 

If  the  contents  are 

less 

than 

2  3  0 ,  the 

they  are  treated  as  numbers.  Each  number  is 

printed  on  a  separate  line. 

(2)  EEd-ElE Ef-  LE  ““  Contents  greater  than  or  equal  to  2 30 
are  converted  to  character  form.  They  are  buffered 
by  the  printer  and  printed  whenever  20  are 
collected,  or  numeric  data  is  encountered  or  the 
end-of-file  character  is  encountered. 

When  the  printer  has  finished  an  operation,  it 
releases  a  unit  of  the  resource  PRINTER  END. 


2.5  DRUM 

The  DRUM  is  i mplement ad  as  a  TOPPS  program.  It 
must  also  be  fired  up  in  the  main  process.  Com  man  ds  are  sent 
to  it  by  using  the  resource  DRUM_START.  When  it  has 
completed  the  operation,  it  releases  a  unit  of  one  of  the 

i.  i  w 

reso  urces : 

DRSNDO,  DEEND  1 ,  DREND2,  DR END 3  or  DR  END 4 

{whichever  is  specified  by  the  DRUM_START  command) . 

The  drum  commands  are  of  the  form: 

(2 3 0  *  <op>)  +  (2.20  *  <drum  page>)  +  (210  *  <address>)  + 

(23  *  <tag>)  +  <ansres> 

where  <op>  =  0  means  write  to  DRUM 

1  means  read  from  DR DM 

<drumpage>  is  the  number  of  the  page  (20  words)  to 
be  read  or  written 

<address>  is  the  starting  address  in  MEMORY  for 
the  transfer 

<tag>  is  a  value  to  be  released  when  the  DRUM  signals 
completion.  This  might  be  used  to  differentiate 
between  commands  sent  by  the  same  process. 

<ansres>  determines  which  resource  is  used  to  signal 
completion.  Each  process  using  the  DRUM  will 
probably  want  to  use  a  different  resource. 

Drum  storage  is  organized  as  a  TOPPS  array, 
DRUMSTORE,  containing  2000  words  (200  pages  of  20  words 
each)  .  Each  command  to  the  DRUM  causes  one  page  to  be  moved 
between  DRUMSTORE  and  MEMORY.  Note  that  the  DRUM  does  not 
in  any  way  differentiate  between  numeric  and  character  data. 


. 
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3 .  1  SYNTAX 

User  programs  t.o  bo  executed  by  the  000/Z  system 
are  written  in  a  very  simple  language.  Its  syntax  is 
defined  by  the  following  BhTT?: 

<nrogram>  <dacl  part>  <blocks>  BEGIN  <label> 

<decl  part>  <eoipty> 

|<decl  st>  <decl  part> 

<decl  st>  ::=  VARIABLE  <identifier> 

1  ARRAY  <identifier>  <nuniber> 

<blocks>  : : =  <block> 

j<blocks>  <block> 


<block>  ::=  FLOCK  <label>  <st  list>  END 


<st 


<  e  in  p  t  y  > 

|<st  list>  <statement> 


<  statements 


GET 


< refer en ce> 


1  PUT 
| RETURN 
1  REPEAT 


<expr ession> 
<expression> 


j IF  <expression> 


TUEN 

ELSE 


<label> 
<la  bel> 


j  <reference>  =  <expression> 
] ENTER  <label > 


<reference>  : 


<expression> 


<  i  d  e  n  ■ 

< ident if ier> 


(<exprsssion>) 


<pr imar y> 

]<primarv>  <op>  <expression> 


<  prim ary > 


| <n  umber> 
j  ( <expression>) 


1- 

I* 

1/ 


<OD> 
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3  .  2  SEMANTICS 

A  <program>  consists  of  a  < led  part>, 
followed  by  one  or  more  <block>' s,  terminated  with  a  BEGIN 
statement. 

The  <"decl  part>  causes  storage  to  be  allocated  in 
the  stack  for  the  variables  and  arrays  specified.  It  also 
defines  their  location  relative  to  the  beginning  of  the 
s  tack . 

Each  <block>  must  be  labelled  and  may  contain  3  or 
more  <sta tement> 1 s.  A  <block>  may  be  entered  In  two  ways: 

(1)  by  executing  an  ENTER  statement  in  another  block 
specifying  the  appropriate  label. 

o  r 

(2)  by  executing  an  alternative  of  an  IE  statement 
specifying  the  block. 


The  first  block  to  be  executed  is  given  by  the  <label>  at 
the  end  of  the  program. 

Normally,  the  statements  within  a  block  are 
executed  sequentially  and  upon  reaching  the  END,  control 
returns  to  the  block  from  which  it  was  entered.  However, 
this  may  be  changed  by  executing  a  RETURN  statement  or  a 
REPEAT  statement.  Whenever  a  RETURN  is  executed,  the 
expression  is  evaluated,  and  if  it  Is  greater  than  zero, 
then  control  returns  to  the  block  from  which  it  was  entered. 
Analogously,  execution  of  a  REPEAT  causes  control  to  branch 
to  the  beginning  of  the  block  currently  being  executed  if 
the  expression  evaluates  to  a  positive  number. 

<Expression> ' s  may  be  formed  from  positive  numbers, 
variables  and  array  elements.  The  assignment  statement 
evaluates  the  expression  and  stores  Its  value  as  the 
variable  or  array  element  to  the  left  of  the  "  =  ". 

PUT  is  used  to  print  the  specified  variable  or 
array  element,  while  GET  is  used  to  input  a  new  value. 

The  IF  statement  may  only  be  used  to  choose  between 
entering  one  of  two  blocks.  It  cannot  contain  other 
statements  as  its  alternatives.  The  THEN  part  is  entered  if 
<expression>  Is  greater  than  zero;  otherwise,  the  ELSE  part 
Is  entered. 

Keywords,  identifiers,  labels  and  numbers  must  be 
separated  by  at  least  one  blank. 


' 


" 


a 


. 
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3.3  PROGRAM  FORMAT 

User  programs  are  written  in  free  format,  but  using 
only  20  characters  of  each  input  card  (a  restriction  of  the 
003/Z  READER)  .  A  card  in  a  program  rust  not  start  with  a 
<number>  as  the  first  non-blank  character  since  TOPPS  would 
not  read  it  as  a  character  string  but  as  a  number. 

<Identif ier> * s  and  <label>’s  are  arbitrary  strings 
of  letters  and  of  numbers  which  must  start  with  a  letter  and 
which  must  not.  be  keywords  of  the  language.  <Number>*3  are 
positive  integers  in  the  range  of  0  to  2  3  1 ,  Tokens  (i.e., 
keywords,  identifiers,  etc.)  must  be  separated  by  at  least 
one  blank.  Comments  may  appear  anywhere  where  blanks  may 
occur  and  are  separated  by  the  symbols  }<*  and  *>». 

Blocks  must  be  ordered  in  such  a  way  that  each  is 
defined  before  it  is  entered.  They  may  not  be  entered 
recursively. 


3.4  AN  EXAMPLE 

CTHIS  PROGRAM  READS 
M  {UP  T 3  20) 

LUMBERS  AND 
PRINTS  THE  LARGE ST> 

VARIABLE  M 
VARIABLE  MAX 
VARIABLE  I 
ARRAY  A  20 

BLOCK  INPUT 
GET  A  { I) 

I  =  1+1 
REPEAT  M-I 
END 


BLOCK  NULL 
<  DO  NOT  HI  NO- 
END 


BLOCK  SET_MAX 
MAX  =  A  (I) 

END 

3L0CK  LOOP 
I  F  A  (I)  -  MAX 

THEN  SET  MAX 
ELSE  NULL 
1  =  1  +  1 
REPEAT  M-I  END 


- 


-  1  7 


BLOCK  MAIN 
GET  K 
T  =  0 

ENTER  INPUT 
1  =  0 
MAX  -  A{0) 
ENTER  LOOP 
PUT  MAX 
E  N  D 

BEGIN  MAIN 


-  18- 


USER  LANGUAGE  TRANSLATOR 


The  state-driven  TRANSLATOR  converts  programs  written  in 
the  000/Z  user  language  into  object  machine  code  which  the 
CPU  can  execute.  Since  the  main  thrust  of  the  project  is  to 
teach  operating  system  techniques  and  not  translator  writing 
techniques,  the  TRANSLATOR  is  supplied.  It  is  implemented 
as  a  T0PP5  process  and  operates  in  a  ’’coroutine”  manner.  A 
detailed  understanding  of  the  TRANSLATOR  is  unnecessary. 
Only  knowledge  of  the  interface  with  the  system  is  required. 
This  interface  is  accomplished  through  the  resources, 
SYSTEM  TO  TRANSLATOR  and  TRANSLATOR  TO  SYSTEM. 


The  TRANSLATOR  is  started  by  releasing  a  unit  of 
S  Y  S  T  E M _? 0_TRANSL AT 0 R  specifying  a  block  of  MEMORY  into  which 
code  may  be  generated: 


i.e.,  210  *  (size  of  block)  +  starting  address. 

It  can  work  on  any  size  of  block  larger  than  one  word .  If 
the  TRANSLATOR  requires  more,  then  more  MEMORY  is  requested 
by  releasing  a  ^unit  of  TRANSLATOR  JTO_S YSTEM .  When  the 
TRANSLATOR  returns  a  code  of  1  to  request  a  new  card,  then  a 
unit  of  SYSTEM_?0_TRANSLATOR  is  released  having  the  value  of 
the  starting  address  of  the  card  in  MEMORY.  The  TRANSLATOR 
emits  code  sequentially  so  that  no  'fixups’  are  ever  made. 
Furthermore,  code  is  relocatable  relative  to  the  starting 
point. 


Communication  with  the  system  is  achieved  by 
releasing  units  of  the  resource,  TR ANSLATOR_TO_S YSTEM,  as 
folio  ws : 


2?o  *  code  +  value. 

For  each  unit  of  TRAN SLATOR_T0_S YSTEM ,  the  *  code'  value  must 
be  tested  until  a  value  of  3  or  4  indicating  termination  of 
compilation  is  received.  The  following  are  the  'cods’  values 
with  their  associated  meanings: 

The  block  of  MEMORY  has  been  filled  up.  The 
system  may  provide  another  block  specified  in 
the  same  way  as  the  initial  one  or  it  can  tell 
the  TRANSLATOR  to  abort  by  releasing  ”-1”. 

Exam  ple_ 

For  the  single  system  described  in  Section  5, 
the  translator  is  given  all  available  MEMORY  in 
which  to  generate  code.  If  MEMORY  is  filled,  then 
it  must,  abort. 

E xam olq_ 2 : 

For  a  full  000/Z,  the  translation  might  be 
done  by  the  IN5P00LEE.  In  this  case,  the 


•- 


i 
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TRANSLATOR  could  be  given  a  block  of  20  words  to 
use.  Each  tine  the  block  is  filled,  a  code  of  0  is 
returned  to  the  system;  the  block  is  writ  tan  to 
drum  and  the  TRANSLATOR  is  restored  using  the  same 
block  again.  Of  course,  when  the  program  is 
loaded,  all  the  20  word  blocks  must  be  loaded 
sequentially  in  memory. 


o  1  e 


=  1 


The  TRANSLATOR  wants  another  source  card.  The 
system  may  restart  the  TRANSLATOR  by  releasing 
the  address  of  a  block  of  20  words  into  which 
it  has  read  a  card  (N.B,  one  character  per 
word).  Alternatively,  it  may  release  ”-1”  if 
there  are  no  more  cards  for  the  job. 


;ode_=_2  The  TRANSLATOR  has  discovered  an  error.  In 
this  case  ” value”  is  as  follows: 


value  =  1  Invalid  token  encountered  (almost 

any  syntax  error) . 

=  10  End  of  file  received  from  system. 
=  30  Symbol  table  overflow. 

=  40  Parse  stack  overflow. 


=  60  Request  for  more  MEMORY  refused. 


cqde_=_3  Compilation  successfully  completed.  "Value”  is 


2 1 0  *  STACK  SIZE  +  PROG  SIZE 


where  ”STACK_SIZE”  is  the  size  of  the  data 
stack  segment  required  for  successful 
execution  and  ”PROG_SIZE”  is  the  size  of  the 
program  generated.  Entry  to  the  program  is 
always  at  ”PRC)G_SIZE  -  5”.  (i.e.,  the  last  3 

instructions  in  a  program  are  always  of  the 
form:  AL  L  SCAT  E<  d  a  t  a  > ,  ENTER  <addr>,  STDP) 

code_=_4  Compilation  was  terminated  abnormally  due  to 
errors.  "Value”  is  as  for  code  =  3,  but  it 
will  not  be  accurate. 


V* 
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5.  A_SIMPLE_EXAM°LE_SYSTEM 

The  example  system  (see  Appendix  E)  provided 

illustrates  the  use  of  the  TRANSLATOR  and  all  the  hardware 

except  the  DRUM.  This  system  does  no  multiprogramming .  All 

of  MEMORY  is  used  if  necessary  for  code  generation  for  a 
job.  The  example  system  contains  no  in spooler  or 
outsp  ooler . 

In  the  example  program,  a  call  to  INITIALIZE  sets 
important  variables;  the  READER,  PRINTER,  and  TRANSLATOR  are 
fired  up.  Then  the  stream  of  users’  jobs  are  processed 

within  a  large  repeat  loop.  These  jobs  have  the  following 
forma  t : 

col.  1  10  13  14  17 

JOB  <TIME_LIMIT>  <I0_LXHIT> 

/program/ 

<da  ta> 

The  TINE_LIHIT  Is  the  maximum  number  of  instructions  that 
the  system  will  allow  the  job  to  execute.  Similarly,  the 
IO_L I  NIT  Is  the  maximum  number  of  I/O  operations  that  a  job 
may  execute.  Both  ?1ME_LIMIT  and  I0_LIMIT  must  be  right 
justified.  The  student  may  find  such  controls  useful  in  his 
system. 

The  system  reads  one  card  at  a  time  into  MEMORY 
starting  at  MEMORY (INPUT_BUFFER) .  The  card  is  printed;  it 
is  translated  into  machine  code  starting  at 
MEMORY (PROG_BASE) .  For  the  execution  of  each  job,  MEMORY 
division  is  as  follows: 

j  < - - MEMO  RY_SIZ  E - >] 


0  20  40 


]  ]  |  < PR0G_SIZE - >J< DAT A_SIZ E-> J 

1 _ ! _ 1 _ ! _ I 

!  i  I  I 

X  N  P  UT_ BUFFER  1  PR0G_BASE  DATA_BASE 

0UTPUT_ BUFFER  first  instruction; 

MEMORY (PR0G_BASE+PR0G_SIZE-5) 


Translation  is  done  by  requesting  the  TRANSLATOR  at 
the  top  of  a  large  loop.  If  the  TRANSLATOR  returns  a  code  of 
’0’  then  no  more  MEMORY  can  be  obtained  and  this  Is 
signified  to  the  TRANSLATOR  by  releasing  a  unit  of 
SYSTEM  JTOJTRANSLA.TOR  with  a  value  of  ’ -1'.  For  a  code  of 
’I1,  a  new  card  is  read.  After  translation  the  card  is 
printed.  The  translation  loop  terminates  for  codes  greater 


' 


. 

' 


' 
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t.kan  2.  Nota  that,  all  TRANSLATOR  errors  are  Ignored  (i.e., 
code- 2) . 

Next  the  CPU  Is  called  as  follows: 


r  rap 


:  =  C  P  !J  ( 


where  <parame ters>  are  as  in  Section  2.2.  The  example 
system  takes  the  appropriate  action  upon  receiving  the  TRAP. 
For  example,  it  must  do  I/O  handling. 

Finally,  the  output  for  a  job  is  printed .  The 
students*  systems  should  print  at  least  the  minimum 
information  given  by  the  example  system,  namely: 

(1)  a  source  listing  for  each  job  including 
its  internal  job  number 

(2)  output  for  the  job 

(3)  job  statistics: 

-  address  and  name  of  last 
i n struct ion 

-  a  statement  that  termination 
was  normal  or  abnormal 

-  number  of  CPU  ops  used 

-  number  of  I/O  traps  used. 

This  is  a  very  simple  system.  Complications  to  be 
introduced  into  the  students’  000/Z  operating  systems  are 
discussed  in  the  following  section. 


. 


' 
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.  Tdf  ..PROJECT*5 

The  purpose  of  the  " toy”  operating  system  is  to 
spool  input  and  output  and  to  execute  users'  jobs  in  a 
multiprogramming  environment.  Most  existing  operating 
systems  have  at  least  these  basic  caoabi lities .  namely 
spooling  ana  multiprogramming.  The  students’  system  should 
also  provide  these  capabilities.  It  is  to  be  implemented  in 
the  TOPPS  language  using  hardware  simulated  by  T3PPS 
programs.  To  simplify  their  task,  this  is  supplied  to  the 
students  along  with  a  translator  {see  also  Appendix  A) . 

Programs  submitted  by  the  000/Z  system  users  are  to 
be  written  in  the  language  described  in  Section  3.  Ail 
translation  is  accomplished  by  the  translator.  A  user  job 
is  to  consist  of  a  program  in  the  user  language  together 
with  some  control  cards.  The  students  may  choose  their  own 
'fob  control  language  corresponding  to  the  organization  of 
their  system. 

The  operating  system  is  to  read  incoming  jobs  from 
the  card  reader  and  to  place  them  on  the  drum.  As  memory 
space  becomes  available,  jobs  are  brought  into  main  memory 
where  they  are  executed  in  a  multiprogramming  environment. 
When  a  job  is  suspended  for  an  I/O  operation,  another  job 
should  be  given  control  of  the  CPU  while  this  trap  is 
handled.  Eventually  the  job  and  results  are  placed  back  on 
the  drum.  Finally  output  is  spooled  from  the  drum  to  the 
printer.  Naturally  many  of  these  activities  occur 
concurrently.  For  example,  jobs  are  being  read  and  printed 
in  parallel  with  the  operation  of  the  CPU. 

Some  information  must  be  maintained  by  the  system 
about  all  user  jobs  in  the  system.  One  method  is  to  define 
an  additional  data  structure  called  the  JOB_TA3LS  which 
holds  information  on  all  jobs.  Since  this  will  be 
implemented  as  a  two-dimensional  array,  then  the  number  of 
jobs  in  the  system  will  be  bounded  by  the  table  length. 
Indices  into  this  table  serve  as  "unique  names"  for  the  jobs 
during  their  life  in  the  system,  and  can  be  passed  between 
modules  of  the  system. 

The  000/Z  system  to  be  written  by  the  students  can 
be  divided  into  three  parts,  an  in spooler ,  an  PUgspeal er , 
and  an  executive .  The  in s Doqle r  is  to  read  programs  and 
data  by  sending  commands  to  the  reader.  It  also  obtains  a 
job  table  index  to  identify  the  job.  The  translator  for  the 
user  language  can  be  associated  with  the  inspooler.  In  this 
case  the  programs  are  assembled,  and  source  and  object 
code  are  written  on  the  drum.  The  outspooler  receives  the 

^  Further  discussion  of  the  project  is  given  in  Appendix  C. 
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index  of  a  job  Ear  printing  from  the  executive.  It  then 
reads  from  drum  the  source  code  of  the  job  and  the  output. 
These  if  prints  on  the  printer.  In  addition  the  outsoooler 
releases  the  job  table  index  of  the  job. 

The  most  important  part  of  the  operating  system  is 
the  executive.  It  is  not  exactly  clear  how  the  executive 
should  be  structured.  Students  have  the  freedom  to  use  their 
own  ingenuity  in  generating  a  design.  The  executive  should 
contain  various  processes  to  allocate  the  facilities  of  the 
system,  taking  care  to  avoid  deadlock.  It  should  load 
programs  into  memory,  schedule  executable  jobs,  handle  traps 
when  they  occur  by  performing  the  requested  I/O,  and  release 
completed  jobs  to  the  outspooler.  Students  should  draw  upon 
the  literature  in  deciding  what  to  include  in  their  systems 
(e.g.  special  scheduling  algorithms  or  complex  memory 
management  techniques) . 

To  illustrate  that  the  operating  system  is 
functioning  properly,  students  can  include  a  process 
simulating  some  of  the  functions  of  the  operator’s  console. 
Messages  could  be  printed  which  clearly  trace  the  execution 
of  a  job  through  the  000/Z  system.  An  added  benefit  is  to 
provide  students  with  the  satisfaction  of  actually  "seeing” 
their  systems  multiprogram. 

Usage  of  the  $J  control  toggle  in  TOPPS  will 
provide  for  the  fastest  execution  of  the  operating  system 
and  so  will  prove  less  expensive  when  debugging.  This  gives 
the  process  currently  executing  enough  time  to  execute  until 
it  finishes  or  is  blocked. 

Each  000/Z  team  Is  expected  to  hand  in  a  listing  of 
their  system  along  with  actual  output  showing  the  execution 
of  a  sample  user  job  stream.  In  addition,  a  manual  for  the 
operating  system  should  be  included.  This  should  discuss 
the  implementation,  explain  the  relationships  between 
components  of  the  system,  detail  special  features,  and 
justify  the  approach  used. 


-  ••  • 
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A..P  P  S  N  D I X  A 

JwL  FOR  RUNNING  000/Z 


To  run  a  000/Z  system  in  our  environment,  a 
procedure  called  000Z  has  been  catalogued.  This  defines  the 
INPUT 2  data  set  containing  the  hardware  and  translator  for 
the  operating  system.  The  hardware,  translator,  and  some 
initial  declarations  are  to  be  included  at  the  top  of  the 
operating  system  by  placing  a  comment  card  containing  a  SO 
(secondary  input  file  control  toggle)  after  the  BEGIN  of  the 
TOPPS  <system>.  INPUT2  is  a  concatenation  of  the  members  of 
USER. TOPPS. 000Z,  namely: 

a  control  card  (l.e,,  OMIT,  $L$M,  $S,  $M) , 

CPU,  READER,  PRINTER,  DRUM,  TRANS. 

The  JCL  required  to  run  000/Z  is  the  following 

//  EXEC  OOOZr , parameters] 

//SYSIN  DD  * 

d 

2ft 

topps  operating  system 


0 

//GO. SYSIN  DD  * 


data 

* 


// 

where  "parameters”  include: 

CONTROL  =  OMIT  It  contains  an  empty  data  set  so  that 

the  hardware  and  translator  are  listed. 

$S  h  symbol  table  dump  is  given  at  the  end 
of  compilation,  as  well. 

SM  The  hardware  and  translator  are  not 
listed.  This  is  the  default. 

SL$ M  The  hardware  programs,  translator,  and 
input  from  SYSIN  are  not  printed. 

CSIZEjGSIZE  =  These  are  the  region  sizes  for  the  COMPILE 

and  for  the  50  steps,  respectively.  Default 
sizes  are  100K  and  150K. 

CFREE, GFREE  =  These  are  the  sizes  of  the  OS/360  work  areas 

for  the  COMPILE  and  GO  steps,  respectively. 
Defaults  are  5000  and  10000  bytes. 


' 


..  ■'  1  *  * 

. 


VERSION 


This  is  the  version  of  the  interpreter  desire! 
The  default  is  LONG,  the  1 50K  version,  but  P4S 
( 1 3 0 K )  may  be  coded  if  desired. 

To  run  the  example  operating  system,  the  following  JCI,  is 
required : 

//  EXEC 

//SYS IN  DO 

//GO. SYS  IN  DD 

// 

A  listing  of  this  system  and  its  output  is  given  in  Appendix 


000Z{  parameters] 

DSN  =  USER . ?0P?S . 000 Z  (EXAMPLE)  , 

DISPOSER 

DSN=USER.  TOPPS  .000Z  (DATA)  , 

DISP=SHR 


■ 
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SUB PROGRAMS  AND  PROGRAMS  PROVIDED 

A  OOO/Z  partial  operating  system  can  be  used  in 
bail  ling  a  "toy  operating  system".  In  our  environment  it  is 
on  a  partitioned  data  set,  USER . TOPPS . 000Z .  The  members  of 
the  data  set  and  their  component  subprograms  and  programs 
are  given  below  with  a  short  description  of  each. 

MEMBER:  OMIT 

This  is  an  empty  data  set  used  to  omit  control 
cards  at  the  start  of  the  TOPPS  operating  system. 

m  r  m  R  r  P  *  ms 

Turns  on  symbol  table  dump.  This  and  the  following 
two  members  contain  a  TOPPS  comment  card  setting  the 
appropriate  control  toggle. 


MEMBER: 

$  M 

Turns 

off  listing  of 

secondary  input  file. 

MEMBER : 

$L|M 

Tu  rns 

off  listing 

of  secondary  (INPUT2) 

and  main 

(5151 N) 

input  f 

lies. 

MEMBER : 

SUBS 

Contains  declarations  of  MEMORY  array,  cun 

j.  * 

s uaa  b les 

and  global  constants.  The  following  subprograms  are  also 
defined,  namely: 


1.  INITIALIZE  {  ) 

Called  from  main  procedure  to  initialize  some 
global  constants. 

2.  INSTRUCTIONS (I) 

Returns  the  character  string  name  of  the  I’th 
instruction  or  * **ERROR**  ’  for  a  non-instruction 
opcode.  Called  from  main  procedure. 

3.  CON V  EPT__TO_CH  AR  (X) 

Converts  1 X*  from  internal  form  to  real 
characters.  Called  from  TRANSLATOR (NEXT_TOKEN)  , 
PRINTER,  and  CON V ERT_TO_S THING. 

A.  DRUM_COMMAND{OP, DRFJ  M  PAGE, ADDRESS, TAG, A  NSRE5) 

Packs  fields  of  drum  command  into  a  single 
value.  Not  used  In  EXAMPLE  system. 

5.  CONVERT_TO_INTERN AL_FOHM  (LOG, STRING, COUNT) 

Converts  the  first  ’COUNT’  characters  of 
’STRING*  into  Internal  form  and  stores  them  starting 


. 

. 


. 
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a  t 


M  C 

La  t_ 


:in: 


'lo: 


Called  by  READER  and  main  procedure. 


M 


CPU 


Contains  th 
parameters:  PROGRAM 

DAT A_5  IZE ,  5  TACK  TOP., 


TOPPS  subprogram, 
BASE,  PRO GRAM_ SIZE, 
TIMER.  The  CPU 


CPU,  called  with 
TC,  DATABASE, 
executes  the  D 00/7 


assembler  instructions.  It  returns  with  a  value  indicating 
the  reason  for  the  trap.  The  CPU  is  called  from  the  main 


program.  The  following  subprograms  are  local  to  the  CPU: 


1 


2. 


3. 


MEMBER:  READER 

This  member  contains  the  program  READER  producing 
the  consumable  P.EADER_END.  As  described  in  Section  2.3, 
this  Inputs  on?  card  and  places  it  in  MEMORY  each  time  a 
unit  of  resource  P.EADEP._ START  is  available.  It  is  fired  up 
by  the  main  process. 

MEMBER:  PRINTER 


This  member  contains  the  program  PRINTER  producing 
the  consumable  PRINTER_END.  Also  see  Section  2.4.  It  Is 
fired  up  by  the  main  process. 

MEMBER:  DRUM 


PROGRAM_F  ETCH (I) 

Assigns  *  I*  the  contents  of  the  next  address 
(NE5f_IC)  in  the  program  stored  in  MEMORY.  If  an 
attempt  Is  made  to  index  out  of  the  program  (i.e., 
NEW_IC  is  negative  or  larger  than  PROGRAM_SIZE- 1) , 
then  a  trap  of  1  is  returned. 


PUSH  (I) 

Pushes  *1*  onto  the  data  stack, 
an  overflow,  TRAP  is  assigned  3. 


If  there  i, 


POP  (I) 

Pops  the  data  stack,  assigning  the  value  to 
’I*.  TRAP  :=  2  if  an  attempt  is  made  to  pop  an 
empty  stack. 


This  member  contains  the  program  DRUM  producing  the 
consumables  DRSNPO ,  DREND1,  DR END 2 ,  DR END 3,  and  DREMD4 .  Also 
see  Section  2.5.  It  too  is  fired  up  in  the  main  process. 

1.  DREND  (I) 

This  subprogram  uses  the  value  of  I  to  select 
the  resource  to  be  released  signalling  completion. 


■ 
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.'1 2 M BFR :  TP  A N  8 


Fired 
programs 


his  dd  ir  bp  r  contains  the  70PPS  program  PR  AN  SLATOR  . 

a  process  in  the  main  program,  it  translates 
written  in  the  ’user  language’  into  ’machine  cor 


Pat 


executable  by  the 


OH 


The  state- driven  translator 


;  t  a  r  t  e  d  by 


leasing  a  unit  of  SY5TEM_TO_TRANSLAr0R  giving 


the  block,  in  memory  into  which  code  may  be  generated.  The 
TRANSLATOR  communicates  with  the  system  by  releasing  units 
of  TRANSLATOR_TO_SYSrEri  with  coded  values.  Further  details 
are  aiven  in  Section  4. 


The 

TRANSLATOR : 


following  subprograms  are  contained  in  the 


1.  MAX  (A,  3) 

Subprogram  returns  the  maximum  of  A  and  B  . 
Called  in  the  main  body  of  the  TRANSLATOR. 

2.  ERROR  (N) 

Returns  the  translator  to  the  system  with  the 
appropriate  error  code.  It  also  stops  compilation  if  th 
error  cole  is  greater  than  9.  This  subprogram  is  called 
by  EMI?_CODS,  CHAR ,  CHECK_TOKEN,  and  PUSH. 

1.  EMI7_C0DF  (OP) 

This  subprogram  emits  code  in  memory  for  the 
operation  OP.  It  is  called  from  the  main  body  of  the 
TRANSLATOR. 

4.  RESERVED  (I) 

C H F C K_ T 0 K B N  calls  this  subprogram.  It  is  used 
in  checking  for  reserved  words.  It  returns  the  I  * th 
reserved  word. 

5.  LOOKUP {ID, TABLE, SIZE) 

This  subprogram  returns  the  position  of  10  in  a 
TABLE  with  SIZE  elements  or  - 1  if  it  is  not  there. 

It  Is  called  by  N EXT_T0KEM. 

6.  CHAR_?YPE  (X) 

CHARJTYPE  returns  X  if  negative,  or  otherwise, 
a  code  for  X  indicating  whether  it  is  a  digit,  a  letter 
or  a  special  character.  It  is  called  by  NEXT_T0KEN. 

7.  CHAR 

CHAR  picks  the  next  character  from  the  card 
stored  in  MEMORY  or  requests  a  new  card  If  necessary. 

It  is  called  by  N EX?_T0KEN. 

3.  NEXTJTOKEN 

The  next  ’token’  from  the  input  stream  is  fetched 
and  a  coded  value  for  the  token  Is  returned.  It  is 
called  by  CHECK  TOKEN. 


. 


- 
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CHECK_TOKEN  (TOKEN) 

This  subprogram  is  called  by  the  main  holy  of 
the  TRANSLATOR.  It  checks  to  see  that  TOKEN  and  the 
next  token  are  the  same. 

10.  POSH  (STACK, I) 

This  subprogram  pushes  I  onto  STACK.  The  stack 
Index  given  by  STACK (0),  Is  incremented.  It  is  called 
in  the  main  body  of  the  TRANSLATOR. 

11.  POP  (STACK  ,  I) 

This  subprogram  pops  the  top  of  the  stack  and 
returns  I  with  that  value.  It  is  called  In  the  main 
TRANSLATOR. 

MEMBER:  EXAMPLE 

This  contains  the  code  for  the  body  of  a  simple 
OGO/Z  operating  system.  It  has  neither  an  inspooler  nor  an 
outspooler  and  does  no  multiprogramming.  All  hardware, 
translator  and  some  basic  declarations  are  included  at  the 
top  of  this  example  by  use  of  the  $F  option.  Further 
details  are  given  In  Section  5.  The  following  subprograms 
are  also  included: 

1. 


2. 


3. 


4  . 


CONVERT _TO_NOtlE8rc  (LOC,  COUNT) 

This  converts  COUNT  digits  starting  at  LOC  into 
a  number  and  returns  that  number.  This  is  called  in  the 
main  body  of  EXAMPLE. 

CONVERT_TO_Sr  RING  (LOC, COUNT) 

This  converts  COUNT  words  starting  at  LOC  into  a 
character  string  and  returns  that  string.  It  is  called 
from  NSXT_CARD. 

NEXT_CARD  (BUFFER.) 

This  reads  the  next  card  and  sets  J03_CARD_READ  . 

It  is  called  in  the  main  body  of  EXAMPLE. 

W E IT  E_BU  PEER (BUFFER, N) 

This  causes  N  memory  locations  to  be  printed 
starting  from  BUFFER.  It  Is  called  in  the  main  body 
of  EXAMPLE. 
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APPFNDIX  C 

EXPERTS  MCE  WITH  OOO/S  AND  TOPPS 

In  1977  fourteen  groups  of  students  in  the 
introductory  operating  systems  course  wrote  a  OOO/Z  system. 
The  rest  of  the  students  were  involved  in  other  projects. 
(In  1973  all  students  taking  the  class  were  asked  to  do  the 
OOO/Z  project.)  The  groups  ranged  in  size  from  one  to  three 
students.  Almost  all  of  the  groups  completed  systems  that 
worked  reasonably  well.  All  the  students  felt  that  they  had 
learned  a  great  deal  from  doing  the  project.  They  felt  that 
the  experience  of  having  to  write  an  actual  system 
themselves  gave  them  much  insight,  which  could  not  have  been 
gained  from  the  lectures  alone,  into  the  problems  involved 
in  operating  systems.  Some  students  felt  that  the  knowledge 
gained  in  the  lectures  could  be  used  in  the  design  of  the 
system.  The  existing  setup  required  the  students  to  do  more 
reading  on  their  own  in  order  to  do  the  project.  Since  this 
was  the  second  year  in  which  OOO/Z  was  used  as  the  course 
project,  students  had  access  to  the  systems  done  the 
previous  year.  This  seemed  to  have  the  effect  of  reducing 
the  variation  between  systems  with  regard  to  the  design 
decisions  made. 

The  students  used  the  TOPPS  language  for  writing 
their  systems.  In  general  the  language  was  found 
satisfactory,  although  the  severe  limitation  on  the  number 
of  strings  allowed  was  found  annoying.  This  was,  however, 
partially  due  to  a  bug  in  the  compiler  which  has  since  been 
corrected . 

The  average  number  of  cards  in  a  OOO/Z  system  was 
1710.  This  number  may  not  be  too  meaningful  since  it 
includes  comment  cards  as  well  as  source  language 
statements.  Perhaps  more  meaningful  is  the  average  number 
of  bytes  of  object  code  in  a  OOO/Z  system  which  was  15,190. 
An  estimated  20  minutes  of  370/165  CPU  time  were  required  to 
complete  a  system.  This  latter  figure  is  based  on  the  old 
version  of  the  compiler  and  the  project.  He  expect  better 
results  in  1973. 

As  the  project  definition  indicates,  000/Z  is  quite 
an  open-ended  project.  Given  the  fixed  hardware 
constraints,  the  students  are  free  to  design  the  software  as 
they  wish,  concentrating  on  those  aspects  of  operating 
systems  which  interest  them  most.  As  a  guideline  they  are 
advised  to  divide  the  system  into  three  sections,  an 
inspooler,  an  outspooler  and  an  executive. 

The  problems  tackled  and  the  approaches  taken 
varied  from  group  to  group.  One  of  the  fundamental  problems 
which  had  to  be  considered  was  that  of  memory  management. 
Several  groups  simplified  the  problem  by  dividing  memory 


. 
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into  several  fixed  size  partitions  and  by  requiring  that  a 
job  wait  until  a  partition  into  which,  it  could  fit  became 
available.  The  more  ambitious  projects  allowed  a  variable 
number  of  jobs  in  memory,  giving  each  job  only  the  amount  of 
memory  it  required.  Although  more  difficult,  to  implement, 
this  scheme  utilizes  memory  more  efficiently.  All  the 
groups  taking  this  approach  gave  jobs  contiguous  memory 
locations,  although  an  alternative  is  to  allow  the  code  and 
data  segments  of  a  program  to  occupy  non-contiguous  regions. 

Another  problem  which  had  to  be  considered  was  that 
of  drum  management.  The  most  simplified  approach  is  to 
divide  the  drum  into  a  fixed  number  of  regions.  This 
however  leads  to  inefficient  use  of  the  drum.  A  better 
approach  is  to  allocate  to  a  job  the  maximum  amount  of  drum 
store  it  will  need  during  execution.  Although  still 
somewhat  wasteful,  the  alternative  of  allocating  drum  pages 
to  jobs  as  needed  during  execution  for  spooling  their  output 
requires  sophisticated  deadlock  checking  algorithms. 

The  problem  of  CPU  scheduling  was  one  which  had  to 
be  considered.  wany  groups  used  a  round  robin  time  slicing 
algorithm  in  which  a  job  was  given  the  CPU  for  a  fixed  time 
slice  unless  it  issued  an  I/O  request,  in  which  case  the  CPU 
was  given  to  the  next  job  waiting  to  execute.  Another 
approach  taken  was  to  allow  a  job  to. execute  for  as  long  as 
it  could,  unless  it  issued  I/O,  rather  than  pre-empting  it 
after  a  time  slice.  Some  groups  used  various  priority 
schemes  for  scheduling  although  most  did  not  bother. 

Although  not  stated  in  the  project  definition,  most 
groups  produced  some  sort  of  console  sheet  to  indicate  the 
sequencing  of  events  throughout  the  system.  Each  section  of 
the  software  (e.g.,  inspooler,  outspooler,  I/O  handler. 
Loader,  CPU  scheduler,  etc.)  would  print  a  message  each  time 
it  did  something.  This  not  only  served  to  demonstrate  that 
the  system  was  in  fact  functioning  correctly  but  was  also  a 
useful  debugging  tool.  The  few  groups  which  did  not  do 
this,  showed  only  the  output  produced  by  the  outspooler. 
This  output  alone  was  often  not  very  illuminating. 

Although  we  generally  discourage  students  from 
changing  the  hardware  specifications,  we  made  one  exception. 
One  group  of  students  was  allowed  to  add  address  relocation 
hardware  in  order  to  implement  a  virtual  memory  system.  The 
project  done  by  this  group  was  by  far  the  best  done  by  any 
of  the  groups. 

In  addition  to  being  used  as  the  course  project  for 
the  introductory  operating  systems  course,  000/Z  has  been 
used  for  several  other  purposes.  A  graduate  student  at  the 
University  of  Toronto  has  designed  and  implemented  a  000/Z 
system  and  is  attempting  to  prove  it  correct.  His  concern 
has  been  primarily  with  structuring  the  system  so  as  to 
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facilitate  the  correctness  proofs  and  not  with  such  details 
as  choosing  particular  algorithms.  T\t  the  University  of 
Saskatchewan#  on  the  other  hand,  a  000/7  system  is  being 
implemented  as  part  of  an  advanced  operating  systems 
seminar.  Their  major  area  of  concern  in  the  design  of  the 
system  is  with  the  choice  of  scheduling  algorithms.  These 
examples  serve  to  show  the  various  and  diverse  uses  to  which 
DOG/7,  has  been  put. 


i 
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APPENDIX  D 


CPU  INSTRUCTIONS  AND  SEMANTICS 

This  appendix  describes  the  various  instructions 
interpreted  by  the  CPU '  subprogram .  Included  is  a"  detailed 
explanation  of  its  semantic  algorithms. 

CPU  instructions  have  lengths  varying  from  one  to 
three  MEMORY  locations  depending  on  the  number  of  operands. 
Most  instructions  executed  by  the  CPU  have  no  operands  since 
they  apply  to  the  top  of  the  stack.  The  following 
instructions  are  executed  by  the  CPU: 


np 


’ODE 


MNEMONIC  S  FORMAT 


T  VMC'T’H 

Xu  ■  3  -U  ■  1 


n 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 
1  1 
12 

13 

14 

15 


BRANCH  <addr  1  Xaddr 2> 
ENTER  <ad  dr> 

RETURN 

REPEAT 

EXIT 

PUSH  <data> 

FETCH 

STORE 

ADD 

SUBTRACT 

MULTIPLY 

DIVIDE 

STOP 

GET 

PUT 

ALLOCATE  <data> 


3 

2 

1 

1 

1 

2 

1 

1 

1 

1 

1 

1 

1 

1 

1 

2 


The  instruction  ENTER  causes  execution  to  continue 
from  the  specified  address  while  BRANCH  chooses  between  the 
two  specified  addresses  depending  on  the  value  of  the  top  of 
the  stack.  A  subsequent  EXIT  causes  execution  to  continue 
from  the  point  where  it  left  off  at  the  last  ENTER  or 
BRANCH.  RETURN  is  a  conditional  exit,  depending  on  the 
value  of  the  top  of  the  stack.  REPEAT  conditionally  resumes 
execution  at  the  point  where  it  began  after  the  last  ENTER 
or  BRANCH.  These  instructions  therefore  provide  looping, 
case  selection  and  program  segmentation. 

PUSH,  FETCH  and  STORE  involve  data  transfers.  PUSH 
puts  its  operand  on  top  of  the  stack.  FETCH  causes  the 
contents  of  the  address  in  the  top  of  the  stack  to  be  pushed 
onto  the  stack.  STORE  stores  the  contents  of  the  top  of  the 
stack  at  the  location  whose  address  is  in  the  second 
location  from  the  top. 

ADD,  SUBTRACT,  MULTIPLY,  and  DIVIDE  perform  the 
specified  operation  upon  the  top  two  items  in  the  stack. 


. 


STD  P ,  G 
trap  codes.  The 
indicates  to  the 


FT  and  PUT  result  in  traps,  with  identifying 
CPFI  does  not  actually  perform  I/O  but.  only 
system  that  it  is  required. 


ALLOCATE  increases 
of  its  operand  to  leave  room 


the  stack  pointer  bv  the  a  mo u n t 

i-  A 

for  storage  in  the  stack. 


The  semantics  of  the  CPU  are  more  precisely 
explained  by  the  pseudo-program  given  below.  Checks  for 
stack  overflow  and  similar  addressing  violations  are 
omitted.  The  following  special  notation  is  used  in  the 
pseudo-program: 

f  leld <n> :  MEMOS?  (PR0GRAM_3AS 5  +  IC  +  <n>) 

data  value <i>:  MEMORY  (DA.TA_BA.SE  +  i) 

<variable>  stack: 

<v  aria  ble>  :=  MEMO  R  Y  { P  AT  A_B A  S  E  +  STACKTOP) 
ST ACKT OP  :=  STACKTOP  -  1 
stack  <--  <expression>: 

STACKTOP  :=  STACKTOP  +  1; 

MEMORY {DATA_8ASE  a  STACKTOP) 

:=  <expression> 

trap  1:  return  from  CPU  with  trap  code  of  ’i? 

"a_?3eudo-C2U" 

REPEAT 

IF  TIMER  <  =  0 
THEN  trap  6 

ELSE  TIMER  :=  TIMER  -  1; 

OPERATION  :  =  fieldO; 

DO  CASE  OPERATION; 


branch: 


i  <--  stack; 
stack  <--  IC  +  3; 

IF  i  >  0 

THEN  IC  :=  field-! 


ELSE  IC 
stack  <-- 


:=  field2; 
IC; 


enter:  stack  < —  IC  +  2; 

stack  <--  field-!  ; 

IC  :=  field  1 ; 

return:  i  <--  stack; 

IF  i  >  0 

THEN  (i  <- 
IC  < 

PLS E  IC  :  = 

repeat:  i  <--  stack; 

IF  i  >  0 

THEN  IC  :=  MEMORY  (DA.TA._SA.SE 
ELSE  IC  :=  IC  +  1; 


-  stack; 
--  stack) 
IC  +  1  ; 


+  STACKTOP) 


' 


■ 


- 


9 x it :  i  <--  stack; 

IC  <--  stack ; 


p  u  sh : 

stack  <--  fieldl; 

IC  :=  IC  +2; 

f  etch : 

i  <--  stack  ; 

stack  <--  data value<i> ; 

IC  : =  IC  +  1 ; 

store : 

j  <--  stack; 
i  <--  stack; 
datavalue<i>  <--  j; 

IC  :=  IC  +  1 ; 

add:  I 

<--  stack; 

j 

< - -  stack; 

stack  <--  i  +  j ; 

IC  : =  IC  +  1 ; 

subtract,  multiply,  divide:  similar  to  add 


stop:  trap  1 5 ; 

get:  STACKTOP  :=  STACKTOP  +  1; 
IC  :=  IC  +  1 ; 


out 


trap  16; 


STACKTOP  :=  S T AC K T 0 P  -  1; 
IC  :=  IC  +  1 ; 


trap  17; 


allocate:  STACKTOP  :=  STACKTOP  +  fieldl  ; 
IC  :=  IC  +  2: 


UNTIL  0; 


- 
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SOURCE 


CODE  OF  AN  EXAMPLE  SYSTEM 


37 
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PART  II: 


TOPPS  USERS 
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INTRODUCTION 


1  . 


In 

asy nc hronous 


the  study  of  operating  systems,  the  concepts  of 
processes  and  of  process  communication  are 


T'ticularly  important.  TOPPS 
oriented  language  designed  for 


concepts . 
prod uc ing 
i  nt  e  r  p  re  te  r 


rn  1  _ 

I  J]0 


is  a 

TOPPS  processor  consists 
a  pseudo-machine  language  code 
which  executes  the  generated 
written  in  the  X PL  language. 


nail  expression- 
students  these 
of  a  Compiler 


an  d 
code . 


or 

Both 


an 
a  re 


Being  an  expression-type  language,  as  opposed  to  a 
statement-type  one  such  as  PL/T ,  TOPPS  evaluates  each 
statement  or  block  to  a  value:  each  subprogram  also  returns 
a  value.  The  value  may  be  used  or  discarded.  However, 
clever  use  of  this  feature  can  provide  for  extraordinary 
programming  power. 


TOPPS  provides  the  user  with  basic  numeric  and 
string  handling  operators  as  well  as  logical  selection  and 
repetition.  Expression  evaluation  is  done  from  right  to 
left  with  no  precedence  of  operators.  The  lack  of  "goto ’s" 
does  force  the  programmer  to  at  least  make  an  attempt  at 
structured  programming. 


Perhaps  the  most  important  language  features  are 
those  implementing  processes  and  interprocess  communication. 
Processes  are  virtual  processors  executing  procedures 
asynchronously  and  in  parallel.  Interprocess  communication 
is  accomplished  through  the  use  of  the  primitives  REQUEST 
and  RELEASE  (abbr.  REQ  and  REL) .  Resources  are  the  special 
data  types  -  like  a  combination  of  Dijkstra’s  semaphores  and 
of  queued  values  -  upon  which  REQUEST  and  RELEASE  operate. 


!  .. 


' 


- 


PROCESSES 


9 


r‘.  proced lire  nay  be  thought  of  as  a  program,  a  self- 
contained  sequence  of  instructions  in  the  object  language  of 
v he  processor  which  will  execute  the  procedure.  We 
introduce  the  abstract  (and  difficult  to  define)  notion,  of  a 
process  to  represent  a  virtual  processor  which  has  been 
assigned  to  a  procedure,  A  system  in  T0PP5  may  consist  of  a 
number  of  processes,  which  function  asynchronously  and 
independently  ot  one  another  except  that  they  may 
communicate  (and  therefore  explicitly  synchronize)  by 
releasing  and  requesting  units  of  resources. 

Conceptually,  each  TOPPS  process  may  be  thought  of 
as  an  independent  hardware  processor  executing  "in  parallel" 
with  the  other  processes.  In  fact,  the  TOPPS  interpreter 
simulates  this  "logical  parallelism"  by  time-slicing 
randomly  among  the  available  processes. 


The 

SUBPROGRAMS 
is  invoked 


re  are  two  tyres  of  procedures  in  TOPPS, 
and  PROGRAMS.  "  A  SUBPROGRAM  is  a  procedur 
as  a  subroutine  by  the  appearance  of  its 


name ly : 
e  which 
name  in 


an  expression  being  evaluated  by  a  process, 
conventional  subroutine  call,  execution  of 
procedure  is  suspended  while  the  process 
invoked  procedure. 


As  in  any 
the  invoking 
executes  the 


In  contrast,  a  PROGRAM  Is  invoked  as  the  result  of 
the  execution  of  a  PROCESS  statement.  When  this  statement 
is  executed,  a  new  process  is  created  which  begins  execution 
of  the  invoked  procedure,  independently  and  asynchronously 
of  the  process  executing  the  invoking  procedure.  The  new 
process  is  referred  to  as  a  son  of  the  old  process,  which  is 
referred  to  as  the  father.  The  processes  are  hierarchically 
related,  somewhat  like  procedures  in  a  block-structured 
language.  There  is,  therefore,  a  process  created  for  each 
invocation  of  a  PROGRAM,  as  well  as  one  for  the  outer  BEGIN 
. END  block  of  the  system.  A  process  continues  to  execute 
until  it  finishes  its  code,  executes  a  RETURN  statement  in 
its  PROGRAM,  or  becomes  blocked  or  d padlocked  by  a  request 
for  an  unavailable  resource,  (See  Section  3.)  The 
termination  of  a  process  does  not  affect  its  descendants. 


■ 

. 
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RESOURCES 


n ter pro cess  communication  and  synch 


achieved  through  the  use  of  r§5Qdrces  and  the 


P 


:ion  as 
imitives 

REQUEST  and  RELEASE  which  operate  upon  resources.  A.  process 
may  REQUEST  that  a  single  unit_  of  a  particular  resource  be 
allocated  to  it.  If  any  units  of  that  resource  are 


available,  the  process  is  given  one.  If 


no 


u  n: 


o  f 


+•  i 


ne 


resource  are  available,  the  process  is  blocked  (i.e.,  its 
execution  is  suspended)  until  its  request  can  be  satisfied. 
Blocked  processes  are  placed  on  a  FIFO  queue  associated  with 
the  requested  resource;  this  queue  is  checked  each  time  a 
unit  of  the  resource  becomes  available. 


Units  of  a  resource  become 
s  issues  a  RELEASE  statement  for 
are  blocked  processes  awaiting  u 
he  newly  available  unit  is  given 
e  queue  and  that  process  is 
ion.  If  there  are  no  outstanding 
e  resource,  the  unit  is  placed  o 
ed  unit  has  a  string,  numeric,  or 
ssaqe)  associated  with  it  which  is 
;  to  which  that  unit  is  subsequen 


available  when  some 
that  resource.  If 
nits  of  the  resource, 
to  the  first  process 
allowed  to  continue 
requests  for  a  unit 
n  a  FIFO  queue.  Each 
logical  value  {i.e., 
made  available  to  the 
tly  allocated. 


There  are  two  types  of  resources  in  T0PP3:  REUSABLE 
and  CONSUMABLE.  The  type  of  each  resource  is  specified  by 
the  programmer  in  the  declaration  for  that  resource. 


Units  of  a  reusable  resource  are  ’’borrowed”  by  a 
requesting  process  and  subsequently  "returned”  using  the 
RELEASE  statement.  A  process  can  obviously  only  release 
units  of  resources  which  it  already  possesses.  The 

programmer  specifies  a  numeric  unit  count  for  each  reusable 

resource  which  indicates  the  number  of  units  of  that 

resource  which  are  initially  available.  This  is  also  the 

number  of  units  which  will  be  circulating  in  the  system  at 
any  time  since  units  of  reusable  resources  are  neither 
created  nor  destroyed,  but  merely  borrowed  and  returned. 


In  contrast,  each  consumable  resource  has  an 
initial  unit  count  of  zero.  Processes  may  be  given  the 
capability  to  ’’mint”  units  of  particular  consumable 
resources.  The  RELEASE  statement  applied  to  such  a 
resource,  thus  has  the  effect,  of  creating  a  new  unit  of  that 
resource.  When  a  unit,  is  allocated  to  a  process  in  response 
to  a  REQUEST,  that  unit  is  "consumed”  and  ceases  to  exist. 


Consumable  resources  may  be  used  to  pass  messages 
by  having  the  "sending”  process  release  a  unit  of  a  resource 
whose  value  is  the  message.  The  "receiving”  process  (which 
obviously  must  know  that  it  is  to  receive  a  message)  must 
request  a  unit  of  that  resource. 


- 


Process  synchronization  and  mutual  exclusion  are 
handled  through  the  use  of  consumable  or  reusable  resources, 
Mutual  exclusion  is  best  accomplished  through- 
reusable  resources  with  unit  counts  of  one. 


th 


use  o' 


. 
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4 •  THE  TOPPS  SYNTAX 
<system>  declaration  block> 

<decl,  block>  : : =  BEGIN  < decl . sta te . list>  <block>  END 
<decl . state. list>  ::=  decl . state . list >  <decl . state. > 


<decl . state. > 


VARIABLE  < id  list>; 

ARRAY  < id  list>  BOUND  <parameter  list>; 
SUBPROGRAM  <ident if ier>  [OF  <id  Iist>] 

IS  <expression> ; 

CONSUMABLE  <id  list>; 

REUSABLE  <id  list>  WITH  <expression>; 
PROGRAM  Cidentif ier>  [OF  <id  list>] 

[PRODUCING  < id  list>  ]  IS  < express ion> 


<bloc  k>  :  :  = 


< state men t> 


<stat emen  t > 

<block>;  <statement> 

<expression> 

|  PROCESS  <primary>  [OF  Cparameter  list>  ] 
[PRODUCING  <parameter  list>  ] 


<expression> 


\ 

I 

I 


<pri mar y > 

-»  <primary> 

<primary>  <operator> 
IF  <expression>  THEM 

ELSE 

REPEAT  <block>  UNTIL 
RETURN  < ex press i on > 


<expression> 
<ex press ion > 
<expression> 
<ex pressionb 


<  prim  ary > 


<constan t> 


<constant> 

(<block>) 

<decl.  block> 

<primary>  ([  <parameter  list>]) 


<inteqer> 

-  <integer> 
<s tring> 


Cparameter  l.ist>  :  :=  <expression> 

|  <parameter  list>,  <expression> 

<id  list>  <identifier> 

|  <id  list>  ,  <identifier> 


<operator>  ;:=  +]~l/l*l<l=l  :=l>j>=  ]<-l”,=  !sll 

Whatever  is  contained  within  square  brackets  is 

optional . 


V 
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This  is  a 


'r,he  syntax  actually 
Appendix  A. 


simplified  version  of  the  TOPPS  syntax, 
used  by  the  compiler  is  given  in 


. 


. 
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5  •  DATA  T  YP  ES 

The  following  data  types  exist  in  TOPPS: 

1.  Coiistddi.5  may  be  °d  string  or  of  numeric 
attr ibu t e . 

2.  Variables  may  have  either  string  or  numeric  values. 

3.  Arrays  are  sequences  of  values,  either  string  or 
numeric  or  both. 

4.  Programs ,  as  described,  are  special  procedures 
used  in  simulating  parallel  processes. 

5.  Subprograms  are  similar  to  XPL  procedures, 
always  returning  a  value. 

6.  I-esqurces,  as  described,  synchronize  processes 
and  queue  information. 

Declarations  enter  the  name  of  the  data  item  in  the 
symbol  table  and  allocate  space  on  the  run  stack  at  runtime. 
Constants  are  entered  into  the  run  stack  directly  at 
runtime.  Variables  and  arrays  are  initially  undefined  at 
runtime.  Program  and  subprogram  entries  have  pointers  to 
the  code  used  to  define  them. 

5.1  CONSTANTS 


<constant>  : : =  <integer>  |  -  <integer>  ]  <string> 

<integer>  <decimal  digit>  |  <integer>  <decimal  digit> 

< dec i mal  d ig i t>  : : -  0|1J2|3J4}5]6]7|8}9 
<string>  : ; =  1 <characters> * |  ’’ 

<characters>  <character>  ]  <characters>  <character> 

<character>  {any  EBCDIC  character  other  than  ’} 

Integers  in  the  range  0  to  231-1  are  valid. 
Negative  integers  may  also  appear  in  TOPPS  programs. 
However,  it  is  impossible  to  input  negative  values  from  data 
cards  at  runtime. 

A  string  constant  is  a  string  of  zero  or  more 

characters  not  including  the  single  quote  (*)  enclosed  by 

single  quotes.  Two  single  quotes  must  be  used  to  represent 
the  occurrence  of  one  single  quote  within  a  string  while  two 
single  quotes  alone  represent  the  null  string.  The  maximum 
length  allowed  for  a  string  constant  is  255.  Strings 
contained  in  input  data  may  be  of  the  same  form  and  enclosed 
in  quotes.  Alternatively,  if  a  character  other  than 

0 , 1, 2 ,3 , 4 , 5 , 6 , 7 , 8 , 9,  blank  or  1  is  encountered  in  the  input 

stream  the  characters  from  that  character  to  the  end  of  the 
card  inclusive  are  input  as  a  string. 


'  - 


- 


. 


<  iden  t  if  ier>  ::=  <letter>  ]  <identifier>  <letter> 

|  <identifier>  <decima.l  digit> 

<letter>  A |B } C ] . . . | Z J _ | 3 1 # ] $ 

< decimal  digit>  =  0 1  1 ] 2  1  3 j 4 j 5 | 6  |  7 J 3 j 9 

An  identifier  is  a  string  consisting  of  a  letter 
followed  by  zero  or  more  letters  or  digits,  where  a),  $, 

#  are  considered  to  be  letters.  The  following  are  reserved 
words  in  TOPPS  and  may  not  he  used  as  identifiers: 

OF 
IS 
IF 

END*" 

THEN 
ELSE 
WITH 
ARRAY 
BOUND 
BEGIN 
•  UNTIL 
RETURN 
R  FPEAT 
PROCESS 
PROG RAN 
VARIABLE 
R EUSABLE 
PRODUCING 
SUBPROGRAM 
CONSUMABLE 

Implicitly  declared  names, 
are  treated  as  identifiers  declared  in 
and  may  be  freely  redeclared  in  TOPPS 
functions  are  not  required). 

5 . 3  DECLARATIONS 

All  declarations  of  data  items  must  occur  before 
the  Item  is  referenced  and  at  the  beginning  of  a  declaration 
block.  Standard  Algol  scope  rules  are  used  for  declared 
items.  Therefore,  declared  data  items  are  not  visible 
outside  the  scope  of  that  block  although  interior  to  the 
block  they  may  be  referenced  or  redeclared  (a  new  data  item 
is  entered  into  the  symbol  table) . 


listed  in  Section  9., 
an  enclosing  block 
(if  the  correspond ing 


. 


. 


. 
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5.3.1  VAP  TABLES 

< decl .state. >  ::=  VARIABLE  <id  list>; 

An  identifier  is  a  variable  if  it  occurs  in  the  <id 
list>  of  a  declaration  statement  of  the  form  VARIABLE  <id 
list>;  any  variable  may  have  numeric,  string,  or  undefined 
values  at  any  time.  Thus  in  the  block 

BEGIN 

VARIABLE  I; 

I  :=  1; 

I  :=  ’OUTPUT  IS’; 

I  :=  3 

END 

the  variable  I  is  first  undefined,  then  number-valued,  then 
string-valued,  and  later  number- valued  again. 

5.3.2  ARRAYS 

<decl . state . >  ARRAY  < id  list>  BOUND  ^parameter  list>; 

An  identifier  which  appears  in  an  ARRAY  statement 
is  array- valued  and  has  the  dimensions  specified  by  the 
expressions  in  the  <parameter  list>  after  BOUND .  The 
expressions  are  evaluated  at  the  time  execution  of  the 
<decl.block>  begins.  If  an  array  has  bounds  31,..., Bn,  then 
the  i ’ th  subscript  can  take  on  values  between  0  and  Bi 
inclusive,  so  that  the  total  number  of  elements  in  the  array 
is  (31  +  1)  { B 2  +  1 )  .  .  .  (Bn+  1 )  . 

Any  use  of  an  array  identifier  after  its  declaration  is 
interpreted  as  a  special  kind  of  subprogram  call  which 
returns  a  reference  to  an  element  of  the  array.  Array 
elements  are  used  in  the  same  way  as  variables. 

E.g.  Array  Code  Bound  Code_Size;  This  declares  an  array 

’Code'  of  size 
1 Code_S i ze  +  1 ' . 

Array  A,B,C  Bound  I,J;  This  declares  three 

2-dimensional  arrays 
of  size  (I+1)x(J+1); 

5.3.3  RESOURCES 

<decl . state. >  ::=  CONSUMABLE  <id  list>; 

j  REUSABLE  <id  list>  WITH  < expression>; 

An  identifier  declared  in  a  CONSUMABLE  or  a 
REUSABLE  statement  is  a  resource,  and  is  respectively 
consumable  or  Erasable.  A  resource  identifier  may  only 
occur  as  a  parameter  for  a  subprogram  or  program  or  a 
resource  parameter  (i.e.,  after  PRODUCING)  for  a  program. 


•  -  « 
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Manipulation  of  resources  is  normally  done  by  the  use  of  the 
implicitly  defined  subprograms  REQUEST  and  RELEASE. 

The  expression  after  WITH  in  the  declaration  of  a 
reusable  resource  specifies  the  number  of  units  of  each 
resource  in  that  REUSABLE  statement.  Initially  all  the 
units  of  a  reusable  resource  are  available  to  he  requested. 
Each  time  a  unit  of  a  reusable  resource  is  requested  by  a 
process,  that  process  becomes  the  owner  of  one  more  unit  of 
the  resource  and  there  is  one  less  unit  available.  Each 
time  a  unit  of  a  reusable  resource  is  released,  then  that 
process  owns  one  less  unit  of  the  resource  and  one  more  unit 
is  available  to  be  used  again.  If  all  the  units  of  a 
reusable  resource  have  been  assigned  to  processes  and  some 
process  requests  a  unit,  then  that  process  is  placed  in  a 
queue  of  processes  awaiting  units  of  that  resource  and 
remains  blocked  until  some  other  process  releases  a  unit  of 
the  resource. 


Initially  there  are  zero  units  available  of  a 
consumable  resource.  There  is  no  fixed  number  of  units  of  a 
consumable  resource,  for  units  of  a  consumable  resource  are 
created  when  a  process  releases  them,  and  they  are  destroyed 
as  soon  as  they  are  obtained  by  some  process.  When  a 
consumable  unit  is  released  it  is  placed  in  a  queue  of 
available  units  of  that  resource.  When  a  process  requests  a 
unit  of  this  resource  it  removes  the  unit  at  the  front  of 
this  queue.  However,  if  the  queue  was  empty  the  process  is 
placed  in  a  queue  of  processes  awaiting  units  of  this 
resource . 

With  both  types  of  resources  when  a  unit  is 
released,  the  FIFO  queue  of  processes  waiting  for  that 
resource  is  checked;  if  the  queue  is  not  empty  then  the  unit 
is  given  to  the  process  at  the  head  of  this  queue,  and  that 
process  is  removed  from  the  queue. 

To  release  a  unit  of  a  reusable  resource,  the 
process  must  own  a  unit.  To  release  a  unit  of  a  consumable 
resource,  the  process  must  be  able  to  produce  that  resource. 
A  process  can  produce  a  consumable  resource  If  it  is 
included  in  the  resource  parameter  list  (i.e. ,  the  producing 
list)  of  that  process  or  if  it  is  declared  within  that 
process . 

E.g.  Consumable  Messages; 

Reusable  Mutex  with  1; 

5.3.4  SUBPROGRAMS 

<decl .  state.  >  SUBPROGRAM  <identifier>  [OF  <id  l.ist>] 

IS  <expression>; 


. 

- 
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The  definition  of  a  subprogram  is  headed  by  the 
reserved  word  SUBPROGRAM  followed  by  its  name  and  its  formal 
parameters  (if  any)  .  The  body  of  a  subprogram  is  the 

expression  following  the  reserved  word,  IS.  Every 

subprogram  call  returns  the  value  of  the  < expression 

forming  the  subprogram  body;  however,  this  value  need  not  be 

used . 

The  parameters  of  the  subprogram  are  local  to  the 
<expression>  constituting,  the  subprogram  body.  They  are 
implicitly  defined  by  their  presence  in  the  parameter  list* 
When  a  subprogram  is  called,  all  parameters  are  passed  by 
reference  except  for  those  which  are  constants  or  which  are 
expressions  evaluating  to  values  which-  are  net  references. 
The  number  of  arguments  in  the  call  (actual  parameters)  must 
match  the  number  of  formal  parameters.  The  parameters  in 
the  subprogram  declaration  must  not  be  redeclared  in  the 
subprogram  body.  Subprograms  may  also  be  called 
recursively*  An  example  of  a  subprogram  is  given  in 
Appendix  F. 

5.3.5  PROGRAMS 

<decl . sta te. >  ::=  PROGRAM  <identifier>  [OF  <id  list>] 

[PRODUCING  <id  list>  ]  IS  <expression> 

Execution  of  a  statement  of  the  form 

PROCESS  <primary>  [OF  <parameter  list> ] 

[PRODUCING  parameter  list>] 

creates  a  new  process  using  the  PROGRAM  with  the  name 

specified  by  the  <primary>.  The  new  process  starts 

executing  quite  independently  of  the  originating  process 
(and  any  other  processes) .  A  process  continues  until  it 
runs  off  the  end  of  its  program,  or  executes  a  RETURN  that 
is  not  inside  a  subprogram.  Any  number  of  processes  can  be 
executing  the  same  program  at  the  same  time.  The  main 
program  itself  constitutes  a  program  and  hence  a  process. 

Processes  communicate  and  interrelate  by  means  of 
resources.  Consumable  resources  are  used  for  passing 
messages  back  and  forth.  Reusable  resources  with  one  unit 

can  be  used  to  give  certain  processes  exclusive  use  of  some 

critical  section  of  a  program.  For  example,  if  READER  is  a 
program  which  five  processes  are  executing,  if  it  is  desired 
that  some  part  of  the  program  RExADER  be  executed  by  only  one 
of  the  five  processes  at  a  time,  then,  a  reusable  resource, 
decla  red 


REUSABLE  MUTEX  WITH  1; 

can  be  requested  on  entry  to  the  critical  section  of  the 
program.  Since  there  is  only  one  unit  of  the  resource,  only 
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one  process  can  be  in  the  critical  section  at  a  particular 
time. 

The  < id  list >  after  the  program  name  is  the  list  of 
formal  parameters,  which  are  analogous  to  tha  formal 
parameters  for  a  SUBPROGRAM,  so  what  was  said  there  applies 
here  too.  They  correspond  to  the  actual  parameters  in  the 
parameter  list  in  the  PROCESS  statement  firing  up  the 
process.  There  is  one  very  important  difference,  however. 
With  subprograms,  parameters  are  passed  by  reference 
whenever  possible  and  by  value  only  If  necessary.  Although 
program  parameters  are  still  passed  by  reference  if  the 
parameter  is  an  array,  a  resource,  a  program,  or  a 
subprogram,  they  are  passed  by  value  if  the  parameter  is 
number-valued  or  string-valued .  Explicitly,  the  difference 
is  this:  with  subprograms,  if  it  is  possible  to  pass  a 
reference  to  a  variable  or  an  array  element,  the  reference 
is  passed.  In  analogous  situations  with  programs,  the  value 
of  the  variable  or  array  element  is  passed  instead.  This 
difference  is  necessary  because  if  Process  1  fires  up 
Process  2  with  a  parameter  list  including  a  variable. 
Process  1  might  change  the  value  of  the  variable  before 
Process  2  can  use  it. 

Programs  also  have  a  resource  parameter  list 
consisting  of  the  consumable  resources  of  which  that  program 
may  release  (i.e.,  produce)  units.  These  formal  parameters 
are  references  to  the  corresponding  actual  parameters  in  the 
PRODUCING  part  of  the  PROCESS  statement  firing  up  the 
process,  and  these  actual  parameters  must  be  consumable 
resources  (or  references  to  them).  When  a  program  releases 
a  unit  of  a  consumable  resource,  it  may  refer  to  it  either 
by  its  name  in  the  formal  parameter  list  or  by  its  name  in 
the  actual  parameter  list.  A  process  which  is  not  declared 
a  producer  of  a  consumable  resource  may  not  release  units  of 
that  resource.  Whenever  one  process  fires  up  another 
process  the  former  must  be  a  producer  of  the  consumable 
resources  Included  in  the  resource  parameter  list.  As  with 
the  normal  parameters  the  formal  resource  parameters  should 
not  be  redeclared  within  the  body  of  the  program  expression, 
since  its  occurrence  in  the  formal  parameter  list 
constitutes  Its  declaration. 

The  PROCESS  statement.  firing  up  a  process  must 
provide  the  number  of  parameters  specified  in  the 
declaration  of  the  program  for  both  parameter  lists.  Unlike 
subprograms,  programs  do  not  return  a  value  to  the  firing-up 
point.  The  result  of  firing  up  a  process  is  that 
<expression>  is  evaluated  (but  its  value  ignored  by  the 
invoker)  . 


■ 
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E.g.  Program  Inputter  of  X  producing  Message  is 

Repeat 

Eel (Message,  X) 

Until  -•  Input  ( X)  ; 

This  program  will  release  the  consumable  ’Message’  with  the 
value  X.  Then  new  data  will  be  read  into  X  and  released. 
This  process  will  continue  until  there  is  no  further  data  to 
read . 

Note:  Further  examples  of  programs  and  processes  are 

presented  in  Appendix  F  of  the  manual. 
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6  •  W_ OF__CONT^O I, 

A  program  written  in  TOPPS  is  considered  a  PROGRAM 
and  is  executed  by  the  main  PROCESS.  Syntactically  it  is  a 
<  S  YST  EM>  with  the  following  format: 


<SYSTEM> 


1 

BEGIN 


DECLARATIONS 

{0  OR  MORE) 


STATEMENTS 
(0  OR 


END 


Varia  bles , 
declared  at 
s  tate  men  t  s 
expressions 
Ex  pres  si on s 


arrays,  resources,  programs,  and  subprograms  are 
the  beginning  of  the  TOPPS  program.  Then  follow 
to  be  executed.  There  are  two  kinds,  namely: 
or  PROCESS  statements  to  fire  up  processes, 
may  be  of  the  following  types: 


(1)  subprogram  calls 

(2)  iterative  expressions  {i.e.  REPEAT’S) 

(3)  selection  expressions  (i.e.  IF’s) 

(4)  assignments 

(5)  return  expressions 

(6)  declarative  blocks. 


Execution  of  processes  is  sequential  except  for  branches 
caused  by  REPEAT’S,  IF’s,  RETURN’S  and  subprogram  calls. 
Termination  of  execution  occurs  whenever  all  PROCES  Ses 
finish  (i.e.  ’fall  off’  the  ends  of  their  respective 
PROGRAMS)  or  when  PPOCESSes  not  finished  are  deadlocked  or 
blocked  by  requests  for  unavailable  resources. 


!  •  \ 
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7. 


BLOCKS 


AND 


STAT 


INEN1 


’S 


<block>  <statement> 

j  <block>  ;  <s ta tement > 


< statements  ::=  <expression> 

|  PROCESS  <primary>  [OF  <parameter  list>] 
[  PRODUCING  <paraaete.r  list>  ] 


<decl . block>  BEGIN  CdecI . state. list>  <block>  END 

<decl . state. list>  ::=  <decl . state .1 ist>  <decl . state . > 

I 


7. 1 


STATEMENTS  & 


DECLARATION 


STATEMENTS 


There  are  two  types  of  statements  in  TOPPS, 
distinguished  in  the  grammar  by  <statement>  and 
<decl . state .> .  Briefly  a  <decl . sta te . >  is  a  statement  which 
declares  a  variable,  array,  or  resource,  or  defines  a 
program  or  subprogram.  A  <sta tement>  is  either  an 
<expression>  (in  which  case  the  value  of  the  <statement>  is 
the  value  of  the  <expression>) ,  or  a  statement  firing  up  a 
process,  beginning  with  the  word  PROCESS  (in  which  case  the 
value  of  the  <statement>  is  zero) ,  or  a  null  statement  (with 
a  value  of  zero).  All  declared  names  are  local  to  the  block 
in  which  they  are  declared.  All  names  must  be  declared 
before  they  are  used.  Eo r  further  details  cn  declarations 
see  Section  5.3. 


Unlike  <stat emen t> ’ s ,  <dec  1.  state>  *  s*  do  not  possess 
values.  When  a  semi-colon  occurs  after  a  <sta teraen t > ,  the 
value  of  the  <statement>  is  lost.  The  following  are 
examples  of  <sta t emen t> 1 s. 


1  .  A  :  =  B 

2.  OUTPUT  ( *  X  IS  *  ,  X) 

3.  RELEASE  { MESSAGE,  ’READY*) 

4.  RESULT  :=  CAT (A,B) 

5.  PROCESS  READER  OF  2,1  PRODUCING  MESSAGE 

6.  PROCESS  WRITE  OF  LINE 

7.  MAX  :=  IF  A<B  THEN  B  ELSE  A 

8.  RETURN  ’ABNORMAL  TERMINATION* 

9.  IF  SWITCH  THEN  BEGIN 

TEMP  :=  VAR 2 ; 

VAR  2  :=  VAR 1 ; 

VAR  1  :=  TEMP; 

END 

ELSE  0 


Examples  of  <decl. s ta te . > * s  have  already  been  given  in 
S ecti on  5.3. 
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7 . 2  BLOCKS  f  DECLARATION  BLOCKS 

There  are  two  types  of  blocks  in  -TOPPS, 
distinguished  in  the  grammar  as  <block>  and  <decl . bloc k>, 
which  have  two  basic  differences.  A  <block>  consists  of  one 
or  more  <sta temen t> 1 s  separated  by  semi-colons.  Note  that 
declarations  are  not  <statement>1 s,  A  <decl.block>  on  the 
other  hand  must  begin  with  the  word  BEGIN  and  end  with  the 
word  END.  A  <decl.block>  need  not  contain  declarations; 
however,  they  must  occur  at  the  beginning  of  the 
<decl.block>  if  they  are  present.  The  rest  of  the 
<decl.block>  is  the  same  as  a  <block>.  A  <decl.block> 
causes  storage  allocation  (even  if  there  are  no  declarations 
inside);  hence  it  should  not  be  used  without  declarations 
when  a  <block>  would  be  more  efficient. 

Note  that  a  <block>  should  not  end  with  a  semi¬ 
colon.  A  <biock>  must  end  with  a  <statement>.  The  value  of 
this  <statement>  becomes  the  value  of  the  <block>.  Since  a 
<decl.block>  contains  a  <block>,  the  same  applies  to  a 
<decl.  block>.  The  value  of  a  <decl.block>  is  the  value  of 
its  <block>.  Thus  all  blocks,  of  both  types,  possess  a 
value.  If  an  extra  semi-colon  is  present  at  the  end,  a  null 
statement  is  assumed  with  a  value  of  zero.  A  warning  is 
printed  at  the  end  of  compilation  if  this  is  detected. 

A  new  scope  (i.e.,  lexic  level  (LL) )  is  entered 
each  time  a  <decl.block>  is  entered  or  a  <subprogram  naine> 
or  <program  name>  is  encountered.  Variables  declared  inside 
a  scope  may  have  the  same  name  as  variables  declared 
outside.  However,  the  same  name  may  not  be  declared  twice 
within  the  same  scope.  The  implicitly  defined  subprograms 
have  lexic  level  zero,  while  names  declared  in  the  outermost 
declaration  block  have  lexic  level  one.  Order  numbers  (ON) 
within  given  scope  are  assigned  in  the  order  declared  with 
the  first  name  having  order  number  zero. 

Examples: 

The  following  are  examples  of  <block>'s: 

1  .  X 

2.  (X  +  3) 

3  .  X  :  =  Y  +  3  ; 

2*Y 

4.  INPUT  (N)  ; 

N  +  (INPUT  (A)  ; 

OUTPUT  (A)  ) 

The  value  of  this  block  is  N  +  A. 


» 
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N  +  BEGIN 

ARP AY  A  BOB N D  10; 
INPUT  (A)  ; 

A{0) 

END 


The  value  of  this  block  is  H  +  A(0) 

The  following  are  examples  of  <decl . block> ’ s: 

1 .  For  this  example  lexic  level  and  order  numbers 
given  above  the  names. 

BEGIN  1,0 

Consumable  Message; 

1,1  2,0  2,1 
Program  Reader  of  X  Producing  C  is 
Begin  3 , 0 

Array  Line  Bound  120; 

3,1  4,0 

Subprogram  Read  of  N  is 
Begin  5,0 

Variable  I; 

• 

End;  3,2  3,3  3,4 
Variable  I ,  J ,  K ; 


End ; 

E  n  d ; 

2.  BEGIN 

VARIABLE  I; 

PROGRAM  P  OF  X  IS  OUTPUT  (X) ; 
INPUT  (I)  ; 

PROCESS  P  OF  I 
END 


are 


. 
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8  .  EXP  RES 5 TONS 

< ex  pres si on>  <primary> 

j  -i  <primary> 

j  <priraary>  <operator>  <expression> 

|  IF  <expression>  THEN  <expression> 

ELSE  <expression> 

|  REPEAT  <block>  UNTIL  <expression> 

]  RETURN  <expression> 

j"  <constant> 

J  (  <bloc k>  ) 

|  <decl ,  bloc.k> 

|  <primary>  ([  <paraaeter  list>  ]) 

<paraaeter  list>  : :=  <expression> 

|  <pararaeter  list>  ,  <expression> 

<  ope  rat  or  +  !  -  ]  /*  !  =  I  :  =  1  <|  >  I  <-  j  >- 1  -*=  |  &  !  ! 

8 . 1  OPERATORS 

All  operators  in  TOPPS  have  equal  precedence  and 
expression  evaluation  is  from  right  to  left,  except  where 
modified  by  parentheses.  There  are  three  classes  of 
o  pera  tors . 

The  first  class  contains  the  logical  and  arithmetic 
operators:  +,  /,  £ ,  |,  and  -> .  The  operands  for  these 

operators  must  have  numeric  value.  An  attempt  to  use  a 
s tri n g- va 1 ued  variable  as  an  operand  causes  an  execution¬ 
time  error  message  and  end  of  execution.  Any  overflow  from 
these  operations  is  ignored;  the  value  after  overflow  is  the 
same  as  in  XPL.  The  logical  operators  (8,  ])  and  the  unary 

not  (-*)  treat  their  operands  as  bit  strings  and  perform 
the  operations  on  corresponding  bits.  Foe  an  expression 
occurring  in  the  phrase  IF  <expression>  then,  as  in  REPEAT 
<block>  UNTIL  <expression>,  only  the  least  significant  bit 
is  used.  Note  there  are  no  unary  plus  or  minus  operations. 
Therefore  -  <expression>  must  be  represented  by  0  - 

<expression>  .  (Negative  constants  are  possible,  however.) 

The  second  class  of  operators  is  the  relational 
operators  (  =  ,  ->=,  <,  <  =  ,  >,  >=)  for  which  the  operands  must 
be  both  numeric  valued  or  both  st ring-valued.  String 
comparison  is  done  as  in  XPL.  STEINGl  <  STRING2  means 
either 

(i)  LENGTH  (STRING  1)  <  LENGTH  (STRING 2) 
or  (ii)  LENGTH  (STRING  1)  =  LENGTH (3TRING2) 
but  there  exists  I  such  that 

BYTE  (STFINGl ,1)  <  BYTE (STSING2 r I)  where 

BYTE  (STHING1 , J)  =  BY TE (STRING2 , J)  for  J=0,...,T-1. 
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Hence  STRING 1=STRING2  if  and  only  if  the  two 
strings  are  identical  (same  length  and  each  corres pond ing 
character  the  sane). 

The  third  class  of  operators  contains  the  single 
operator  the  assignment  operator.  The  value  on  the 

right  hand  is  stored  'in  the  location  specified  on  the  left 
hand  side,  destroying  the  old  value.  The  operands  may  be 
either  string-valued  or  numeric- valued  and  do  not  have  to 
have  the  same  type  of  value.  The  value  of  an  expression  of 
the  form  A:=3  is  the  value  of  3.  Hence  the  expression 
(A:  =  (B:=3)+2)  has  value  5,  and  A:  =6- 1+3  assigns  to  A  the 

value  2. 

8  *  2  CONDITIONALS 

<expression>  : :=  IF  <expr ession> 1  THEN  <expression> 2 

ELSE  <expression>3 

< expr ession> 1  is  evaluated.  If  the  least  significant  bit  is 
1 ,  then  the  value  of  <expression>  is  the  value  of 
<expresslon>?,  Otherwise,  it  is  the  value  of  <expression> 3 . 

E.g.  IF  A  THEN  OUTPUT  (1) 

ELSE  OUTPUT  (2)  . 

In  this  case,  if  A  is  an  odd  number 
(i.e.  least  significant  bit  is  _1)  then 
a  1 1 1  is  printed;  otherwise,  a  ’2*  is  printed. 

8.3  LOOPS 


<expression>  ::=  DEFEAT  <block>  UNTIL  <expresslon> 

Loop  expressions  are  realized  by  the  REPEAT 
construct.  The  <block>  is  always  executed  at  least  once, 
and  is  reexecuted  until  the  <expression>  following  UNTIL  is 
true  (i.e.,  has  least  significant  bit  with  value  1)  .  The 
value  of  the  loop  expression  is  the  value  resulting  from  the 
last  execution  of  the  block. 

8 . 4  SU8PR0GR AN  CALLS 

<expression>  :  :=  <primary>  !  <primary> 

<primary>  ::=  <primary>  ([  <parame ter  list>]) 

A  subprogram  call  causes  execution  to  branch  to  the 
subprogram  code  while  still  remaining  within  the  same 
process.  The  expression  attached  to  the  subprogram 
definition  is  evaluated;  the  result  is  returned,  and 
execution  continues  In  the  calling  process.  Subprograms  may 
be  called  recursively. 
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Parameters  are  passed  by  reference,  if  possible 
(i.e.,  if  the  actual  parameter  is  not  a  constant  or  an 
expression  containing  operators) .  The  call  must  provide  the 
number  of  parameters  snecified  in  the  declaration  for  the 

i.  V 

subprogram.  Each  parameter  is  an  expression  which  may  also 
contain  subprogram  calls.  Subprogram  parameters  may  be 
references  not  only  to  variables,  but  also  to  arrays, 
subprograms,  programs  or  resources. 

Note  that  in  calling  a  subprogram  with  0  arguments, 
the  brackets  must  still  be  retained  (i.e.,  <primary>()  ) . 

Array  references  are  treated  as  special  cases  of 
subprogram  calls  in  which  the  parameters  are  interpreted  as 
subscripts. 

The  resultant  value  of  a  subprogram  is  a  reference 
where  possible.  (It  is  not  possible  if  the  final  expression 
in  the  subprogram  is  a  constant  or  an  expression  involving 
operators  or  a  locally  declared  identifier.)  It  may  be  a 
reference  to  any  type  of  identifier.  Subprogram  calls  such 
as  the  following  may  be  used: 

(1)  ?{I):-EXP  If  F(I)  returns  as  its  value  a  reference  to 

a  variable  or  array  element,  then  the  value  of 
the  expression,  EXP,  will  be  assigned  to  that 
variable  or  array  element. 

(2)  F  (I)  ( A , B ,  C )  If  F  (I)  returns  as  its  value  a 

reference  to  a  subprogram,  then  this 
expression  will  cause  that  subprogram  to  be 
called  with  parameters  A,  B,  and  C. 

(3)  PROCESS  F  (I)  OF  X,Y  PRODUCING  Cl  If  F  (I)  returns 

as  its  value  a  reference  to  a  program,  then 
this  statement  will  fire  up  a  process  using 
that  program. 

(4)  REQUEST  { F  ( )  )  If  F  {)  returns  as  its  value  a 

reference  to  a  resource,  then  this  expression 
causes  the  running  process  to  request  a  unit 
of  that  resource. 

8.5  RETURNS 


<expression>  : :=  RETURN  <expression> 

By  means  of  RETURN  <expression>  a  return  may  be 
made  from  arbitrary  points  in  a  subprogram  or  in  a  program. 
This  provides  an  easy  way  of  branching  out  of  deeply  nested 
constructs  (e.g.,  nested  blocks).  The  value  returned  is 
that  of  the  <expression>  after  the  RETURN. 


^  I  ' 
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9.  IMPLICITLY  DEFINED  SUBPROGRAMS 


Unless  an  explicit  declaration  is  used  to  redefine 
them,  several  names  have  special  meaning  in  TOPPS:  INPUT, 
OUTPUT,  LENGTH,  BYTE,  SUBSTR,  CAT,  REQ,  REL,  REQUEST, 
RELEASE,  NUMERIC,  DELAY.  The  effect  is  as  though  they 
were  declared  in  a  containing  scope.  The  parameters  may  be 
any  type  of  expression  *  as  long  as  the  value  of  the 
expression  is  a  value  or  a  reference  which  abides  by  the 
rules  specified  below. 

9  •  1  INPUT/OUTPUT 

9.1.1  INPUT  (El  ,  E2,  .  .  .) 

INPUT  may  have  any  number  of  parameters.  These  must 
be  variables,  array  references  or  arrays,  or  subprograms 
returning  references  to  such.  Unless  an  array  is  used  as  an 
input  parameter,  successive  values  in  the  input  stream  are 
assigned  to  successive  parameters.  If  an  array  is  used  as  an 
input  parameter  then  values  are  read  in  from  the  input 
stream  until  a  value  Is  assigned  to  each  array  element. 
Array  elements  are  assigned  with  the  rightmost  subscripts 
varying  most  rapidly. 

The  value  of  an  expression  of  the  form 
INPUT (El , E2, ..., En)  is  1  if  there  was  input  data  for  all  the 
E 1 , E2 , . . . , En ,  and  zero  if  there  was  no  input  data  for  En 
(or  insufficient  data  if  En  is  an  array).  Only  one  attempt 
is  made  to  read  past  the  end  of  data.  Any  further  attempts 
result  in  termination  of  execution. 

When  an  attempt  is  made  to  input  lata  into  a 
variable  or  array  element,  INPUT  starts  scanning  the  input, 
cards,  skipping  blanks,  from  the  particular  column  where  it 
stopped  scanning  for  the  previous  input  value,  and  proceeds 
scanning  until  it  finds  a  valid  <integer>  or  <string>  or 
until  it  encounters  a  character  other  than 
0 , 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8, 9,  blank  or  *  in  which  case  all  characters 
from  that  character  to  the  end  of  the  card  inclusive  are 
input  as  a  string.  Note  again  that  negative  values  cannot  be 
input . 

9.1.2  OUTPUT  (El ,E2, . . . ) 

OUTPUT  is  similar  to  INPUT  in  that  it  may  have  any 
number  of  parameters  which  must  be  number  or  string  valued. 
Array  output  is  analogous  to  array  input. 

The  value  of  OUTPUT  (E 1 , E2 En)  as  an  expression 
is  the  value  of  En  and  may  be  either  string  or  number 
valued.  If  En  is  an  array  then  the  value  of 
OUTPUT  (E 1 , E2 En)  is  the  last  value  output.  An  attempt  to 
output  an  undefined  value  causes  printing  of  a  question 


. 


. 


: 


. 


so 


mark.  The*  maximum  possible  length  of  an  output  line  is  131 
c haracte rs . 

Each  time  a  call  to  OUTPUT  is  made  printing  starts 
at  the  beginning  of  a  new  line  and  the  values  that  are 
printed  by  that  particular  call  to  OUTPUT  appear  on  the  same 
line  as  far  as  possible.  If  there  is  insufficient  space  at 
the  end  of  a  line  to  print  an  entire  string  or  number,  then 
none  of  the  value  is  printed  on  that  line,  but  rather  the 
printer  skips  to  the  beginning  of  the  next  line  and  starts 
printing  the  value  there.  If  the  string  has  more  than  131 
characters,  then  the  first  131  characters  will  be  printed  on 
the  first  line,  and  as  many  lines  as  required  will  be  used 
to  print  the  remainder.  When  values  are  output  on  the  same 
line,  a  blank  is  automatically  inserted  between  each  value. 
Thus,  OUTPUT  (ONE ,  *.* ,TWO)  where  ONE  has  value  1  and  TWO  has 
value  2  will  output  the  line  1.2.  If  blanks  are  not 

desirable,  then  it  is  necessary  to  first  concatenate  the 
parameters  so  there  will  only  be  one  output  value: 
OUTPUT  (CAT (ONE, 1 .  ' ,TWO) )  .  It  is  possible  to  print  negative 
values.  For  example,  OUTPUT  (-5)  will  cause  -5  to  be  printed. 

9 . 2  CHARACTER  STRING  MAN I PU L AT I ON 

There  are  four  character  function  In  TOPPS:  LENGTH, 
BYTE,  SUBSTR  and  CAT.  The  first  three  are  similar  to  the 
analogous  function  in  XPL  or  PL/I,  and  CAT (El , . . . En}  is  like 
XPL  E 1 j  |  .  .  .  |  ] En.  If  a  numeric  value  Is  used  in  a  string 
function,  the  expression  is  converted  to  a  string.  In  the 
following  it  is  assumed  that  this  conversion  has  occurred  if 
nece  ssa  r  y . 

9.2.1  LENGTH 


LENGTH  {El  ) 


This  function  must  have  only  one  parameter  which 
may  be  either  string- va lued  or  number- valued.  Its  value  Is 
a  numeric  value  equal  to  the  number  of  characters  in  the 
{converted)  string  denoted  by  El. 

e.g.  LENGTH ( 'ABC*)  =  3 
LENGTH  (-2)  =  2 
LENGTH  (2)  =  1 

LENGTH  {*’**)  =  1 

9.2.2  BYTE 


BYTE  (E1,E2)  El  is  number-valued  or  string-valued 

or  BYTE  (El)  E 2  is  assumed  to  be  0 


The  value  of  this  function  is  the  numeric  EBCDIC 
representation  of  the  E2*th  character  (zero  origin  indexing) 
of  the  string  El.  El  must  be  either  number- val ued  or  string¬ 
valued;  E2  must  be  number- valued .  An  attempt  to  use  BYTE 
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with  a  ^ value  for  P2  greater  than  the  length  of  51  causes 
termination  of  execution.  A  negative  value  for  E2  causes  a 
warning  to  be  printed  and  zero  to  be  returned  as  the  value 
of  the  BYTE  function.  BYTE  may  not  be  used  on  the  left  of 
an  assignment. 


e.g.  BYTE  (*  123  '  ,  2)  has  the  EBCDIC  value  of  »3»  or 

F3  in  hex. 

BYTE  ( 1 123')  .has  the  EBCDIC  value  of  »1*  or 

FI  in  hex. 

BYT E ( ’ 1 1 , -  1 )  causes  a  warning  to  be  printed 

and  has  the  value  of  0. 


9.2.3  SLJ3S T R 

SUBSTS  (E1,E2,E3)  E2,E3  number  valued,  El  number  or 

string  valued 

or  SUBSTS  (El,  E2) 


This  function  has  as  its  value  the  substring  of  the 
string  El,  starting  with  the  E2'th  character  (using  zero 
origin  indexing)  and  continuing  for  E3  characters,  so  that 
the  length  of  the  substring  will  be  E3 .  SUBSTS  may  be  used 
with  only  two  parameters  in  which  case  the  substring 
consists  of  the  characters  from  the  E2’th  to  the  end  of  El. 
An  attempt  to  take  a  substring  beyond  the  end  of  the  string 
causes  termination  of  execution.  Negative  arguments  for 
either  E2  or  E3  cause  the  null  string  to  be  used  as  the 
value  of  SUBSTS. 

e.g.  SUBSTS (»ABCD» , 1 ,3)  yields  'BCD’ 

SUBSTS (' ABCD’ , 2)  yields  'CD' 

SQRSTR ( ’ A3CD * , -  1 , -  1 )  causes  a  warning  to 

be  printed  and  yields  the 
null  string 


9.2.4  CAT 

CAT  {E 1 , E2 , . . .  , EM)  2<N<16  each  El  is  string  valued  or 

number  valued. 

The  value  of  this  function  is  the  string  resulting 
from  the  concatenation  of  strings  E1,...,En.  If  the  result 
of  the  concatenation  is  a  string  with  length  greater  than 
255,  then  a  non-fatal  execution- time  error  message  is 
printed  and  the  rightmost  characters  are  deleted. 

e.g.  CAT  ( »AB» C ')  yields  »AB*C’ 


9.3  RESOURCE  HANDLING  FUNCTIONS 


9.3.1  REQUEST 


REQUEST  (El)  or  REQ  (El)  where  El  must  be  a  reference  to 
a  resource. 


mast  be 


This  function  must  have  exactly  one  parameter  which 
a  reference  to  a  resource. 


A  call  to  this  function  causes  the  following  to 
occur:  if  a  unit  of  the  resource  is  available  then  the 
process  performing  the  request  obtains  a  unit  of  that 
resource.  The  units  of  a  reusable  resource  are  all  initially 
available.  Units  of  a  consumable  resource  are  not  available 
until  they  have  been  released  by  some  process.  If  a  process 
obtains  a  unit  of  a  reusable  resource,  then  that  process 
owns  that  unit  until  it  releases  it.  If  a  process  still  owns 
some  units  of  a  reusable  resource  when  it  finishes,  in  other 
words,  if  it  has  failed  to  release  a  unit  of  some  reusable 
resource  it  requested  then  execution  will  terminate  with  an 
error  message.  If  a  process  obtains  a  unit  of  a  consumable 
resource  then  the  unit  is  ’consumed*.  In  ether  words,  the 
value  Is  lost  except  that  it  is  transferred  to  the 
expression  BEQUEST  (El)  . 


If  there  is  no  unit  of  resource  El  available,  then 
the  process  is  placed  in  a  queue  awaiting  units  of  that 
resource  and  remains  blocked  until  it  obtains  a  unit. 


The 

value  of  the 
unless  that 
being  placed 


value  of  BEQUEST  (El)  as  an  expression  is  the 
unit  of  El  obtained.  The  value  is  numeric  zero 
unit  has  been  released  with  some  other  value 
In  it. 


9.3.2  RELEASE 

RELEASE  (E1,E2)  El  must  be  a  reference  to  a 

resource,  E2  is  string-  valued 
or  number- valued 

RELEASE  (El)  E2  is  taken  to  be  0 


BEL  may  be  used  in  place  of  RELEASE  in  either  form. 


A  call  to  this  function  causes  a  unit  of  resource 
El  to  be  released  with  value  E2.  Therefore,  the  value  of 
RELEASE (El , E2)  as  an  expression  is  E2,  and  the  value  of 
RELEASE (El)  is  zero. 


If  El  is  a  reusable  resource,  then  the  releasing 
process  must  own  a  unit  of  that  resource  (i.e.,  the  process 
must  have  requested  and  received  a  unit  of  the  reusable 
resource  in  the  past) .  Releasing  a  unit  of  a  reusable 
resource  returns  that  unit  to  the  appropriate  queue  of 
available  units  of  that  resource  with  a  value  equal  to  that 
of  E2.  The  process  releasing  the  unit  of  the  resource  no 
longer  owns  that  unit.  Execution  is  terminated  if  a  process 
attempts  to  release  a  unit  of  a  reusable  resource  without 
owning  one. 
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If  El  is  a  consumable  resource,  then  the  releasing 
process  must  be  a  producer  of  that  resource  (i.e.,  The 
resource  must  be  contained  within  the  resource  parameter 
list  for  that  process  or  be  declared  within  the  PROGRAM 
which  was  invoked  as  a  process) .  Releasing  a  unit  of  El  in 
effect  creates  a  unit  carrying  the  value  of  E2  and  places 
that  uni+  in  a  queue  of  available  units  of  El  unless  a 
process  is  awaiting  a  unit  of  El.  This  unit  will  be 
destroyed  when  some  process  obtains  it. 

For  either  type  of  resource,  there  is  nothing  to 
prevent  a  process  from  obtaining  a  unit  of  a  resource  which 
it  previously  released. 

9  OTHER  FUNCTIONS 

9.4.1  NUMERIC 

NUMERIC  (El)  El  may  be  number- va lued  or  string¬ 

valued. 

This  function  may  only  have  one  argument.  If  the 
expression,  El,  is  number  valued,  then  the  function  returns 
1.  If  it  Is  string  valued,  then  it  returns  a  value  of  0. 
e.g.  NUMERIC ( ‘ NUMBER ’ )  returns  0 
NUMERIC (999)  returns  1 

9.4.2  DELAY 

DELAY  (El)  El  must  be  number-valued 

Note:  The  DELAY  function  Is  only  available  In  the 

larger  version  of  the  TOPPS  interpreter. 

To  explain  the  DELAY  function,  it  is  first 
necessary  to  explain  that  there  are  two  clocks  internal  to 
TOPPS  which  have  no  relationship  either  to  each  other  or  to 
real  time.  These  clocks  are  called  the  "machine  cycle  clock” 
and  the  "simulation  clock".  The  time  statistics  printed  for 
each  process  after  execution  are  based  on  the  machine  cycle 
clock  which  is  based  on  one  time  unit  per  ideal  machine 
Instruction.  The  second  clock  is  the  simulation  clock  which 
is  entirely  controlled  by  calls  to  the  subprogram  DELAY. 
(Note  that  DELAY  does  not  affect  the  machine  cycle  clock). 
Each  process  can  be  considered  to  have  its  own  simulation 
clock . 


These  clocks  initially  have  a  time  setting  of  zero, 
A  simulation  clock  is  changed  by  a  call  DELAY  (El)  which 
causes  the  simulation  clock  of  the  process  making  the  call 
to  be  set  ahead  El  simulation  clock  time  units.  As  long  as 
there  is  a  process  whose  simulation  clock  has  an  earlier 
setting  than  the  delayed  process,  then  the  delayed  process 
will  not  proceed.  In  general,  only  the  processes  with  the 
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currently  smallest  simulation  clock  time  setting  are 
executed.  If  all  the  processes  with  the  currently  smallest 
time  setting  finish  or  become  blocked,  then  their  simulation 
clocks  are  moved  ahead  to  the  time  of  the  next  smallest  time 
setting,  and  then  all  unblocked  processes  with  that  time 
setting  are  executed.  For  example,  suppose  there  are  three 
processes  PI,  P2,  and  P3.  Initially  their  simulation  clocks 
all  read  zero.  PI  calls  DELAY  (2),  Its  clock  is  reset  to  2. 
P2  and  P3  then  proceed  until  both  are  blocked.  Their  clocks 
are  reset  to  2.  PI  proceeds  and  suppose  it  releases  units 
that  cause  P2  and  P3  to  become  unblocked.  All  three 
processes  continue  execution.  Suppose  PI  calls  DELAY  (1)  and 
P2  calls  DELAY  (2) .  Then  their  simulation  clocks  are  set  to 
3  and  to  4  respectively.  If  P3  should  become  blocked,  then 
PI,  the  process  with  a  clock  time  of  3,  which  is  currently 
the  lowest,  proceeds.  And  so  on.... 

The  simulation  clock  mechanism  must  be  activated  by 
the  $A  control  toggle  (see  Appendix  C)  . 

DELAY  provides  a  way  of  controlling  the  relative 
speeds  of  execution  of  processes.  However,  to  be  effective 
delays  should  be  used  in  all  processes.  The  effect  would 
roughly  be  to  slow  down  processes  in  proportion  to  their 
relative  increments.  An  example  of  the  use  of  DELAY  is  given 
in  Appendix  F. 
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APPENDIX  A 

TOP PS  GRAMMAR  USED  BY  THE  COMPILER 

<SYSTEM>  ::=  <DECI.  BLOCK  >  _  | 

<RLOCK>  ::=  <  STATE MEN  T> 

1  <BL  OCK>  <SEMICOLOM>  <STATEMENT> 

< S EM ICOLON>  ; 

< STATEMENT  :  :  =  < EXPRESSION 

|  PROCESS  <PRI MAR Y>  <PARS>  <PROD  PART> 


<  P  R  0  D  PART>  ;:  = 

|  PRODUCING  < PARAMETER  LIST> 

< P ARS>  = 

|  OF  <PARAMETE R  LIST> 

<  EXPR  ESSI 0  N>  <PRIMARY> 

|  -  <PRIMARY> 

|  <PRIMARY>  <OPERATOR>  <EXPRESSION> 

1  <1?  CLAUSE>  <TRUE  ?ART>  <FAL SE  PART> 

|  <REPEAT>  <BLOCK>  UNTIL  ^EXPRESSION 
!  RETU  RN  <  EXPR ESSION> 

<  REPEAT>  ::=  REPEAT 

< IF  CLAUSE>  IF  <EXPR ESSIO N> 

<TRUE  PART>  THEN  <EXPRSSSION> 

<  FALS E  PART>  : :=  ELSE  <EXPRESSION> 


<PRIMARY>  ::  =  <IDENTIFIER> 

|  < CONS TAN T> 

|  {  <BLOCK>  ) 

!  <DECL  BLOCK> 

|  < PRIM ARY>  (  < PAP L IST>  ) 

<PARLIST>  ::= 

}  <PAP.AMETER  LIST> 


<CONSTANT>  ::=  <INTEGER> 

|  -  <T  NTEG  ER> 

1  <STRING> 

< PARAMETER  LIST>  ::=  <EXPRESSION> 

|  < PARAMETER  LIST>  ,  <EXPRESSION> 


<  DECL  BLOCK> 


<BEGIN>  <DECL  ST  LIST>  <BLOCK>  END 
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3  5 

<BEGTN>  : 

:=  BEGIN 

3  6 

<  DEC L  ST 

LIST> 

37 

I  <  D E C  L  ST  LI S  T>  <  DECL  ST> 

3  8 

<  DECL  ST> 

::=  VARIABLE  <ID  LIST>  ; 

3  9 

i  ARRAY  <  ID  L  1ST  >  BOUND  PARAMETER  LIS 

4  0 

|  <SUBPRO  GRAD  NAM E>  <ARG  LIST>  IS 

<EXPRESSION>  ; 

4  1 

1  CONSUMABLE  <TD  LIST>  ; 

4  2 

|  REUSABLE  <ID  LIST>  NITH  <SX?RESSION> 

4  3 

|  <PRO GRAM  NAME>  <ARG  LI5T> 

<RE SOURCE  LIST>  <EXPRESSION>  ; 

44 

< ID  LI ST> 

=  <ID  ENTI FIER> 

45 

|  <ID  LIS  T>  ,  <IDENTIEIER> 

4  6 

<  SDBPEOGF. 

AM  NAME>  SUBPROGRAM  <IDENTIFIER> 

47 

<ARG  LIST 

>  : : =  OF  <ID  LIST> 

4  8 

1 

49 

< PRO GRAM 

NAM E>  ::=  PROGRAM  <IDENTIFIER> 

50 

< RESOURCE 

LIST>  : : =  IS 

5  1 

j  PRODUCING  < ID  LIST>  IS 

52 

<OPERATOR>  + 

53 

1  ~ 

54 

1  - 

55 

1  / 

56 

1  < 

57 

i  - 

58 

1  :  = 

59 

1  > 

60 

1  <= 

6  1 

1  '>= 

62 

1  -= 

6  3 

1  6 

64 

1  1 

‘ 

. 


’ 
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APPENDIX  B 
PROGRAM  FORMAT 

TOPPS  programs  are  coded  in  free  format.  Blanks  may 
be  inserted  anywhere  except  within  identifiers,  constants, 
and  reserved  words.  Blanks-  must  be  used  to  separate  any 
adjacent  pairs  of  any  combination  of  identifiers,  numbers, 
and  reserved  words. 

The  following  is  required  to  run  a  TOPPS  job: 

//  EXEC  TOPPSCGf  , YERSIO N  =  PASS 2  ] 
topps  program 

//GO. SYS  IN  DD  * 
data 


// 


Coding  V ERS I0N=PASS2  causes  the  130K  interpreter  to 
be  used.  The  default  is  the  150K  interpreter. 

If  only  a  TOPPS  compilation  is  required,  then  the 
following  JCL  is  required: 

//  EXEC  TOP P SC 

topps  program 

// 

To  execute  a  TOPPS  object  module,  the  following  is 

required : 

//  EXEC  TOPPSG 

//FILE 1  DD  <data  definition  for  object  module> 

//GO. SYS  IN  DD  * 


data 


// 


APPENDIX  C 


COMMENTS  &  CONTROL  TOGGLES 

A  comment  is  initiated  by  the  symbol  /*  and 
terminated  by  */  as  in  PL/I  and  XPL.  The  comment  may  contain 
any  string  of  characters  except  */  and  may  appear  anywhere 
in  the  program  where  a  blank  is  permitted.  All  text  inside 
comments  is  ignored  by  the  compiler  except  for  certain 
characters  preceded  by  $.  These  complement  the  values  of 
control  toggles  for  certain  optional  actions  of  the  compiler 
or  interpreter. 


COMPILER  TOGGLES 


INITIAL  MEANING 

VALUE 


$C  FALSE  List  the  object  code  after  compilation. 

$F  FALSE  Obtain  input  from  file  INPUT 2  when  true 

(otherwise  input  comes  from  file  SYSIN) ,  This 
provides  a  simple  way  of  including  text  from 
another  place  {e.g.,  a  source  library)  at  the 
time  a  program  is  compiled.  The  toggle  can  be 
turned  off  by  use  of  $E  on  a  card  in  the 
INPUT2  file;  alternatively,  it  is 


automatically  turned 
occurs  on  INPUT 2. 

off 

when 

end-of-f ile 

$L 

TRUE 

List  source  code 

that 

co  mes 

from 

SYSIN . 

3  H 

T  RUE 

List  source  code 

that 

comes 

f  rora 

INPUT 2. 

$S 

FALSE 

Dump  the  symbol 

table 

after 

compilation . 

INTERPRETER  TOGGLES 


(i) 


BA1  FALSE  Activates  the  delay  option  (i.e.,  turns  on  the 

simulation  clocking  mechanism  associated  with 
the  DELAY  function) . 

$13  FALSE  Use  an  instruction-by-instruction  time-slice 

for  simulation  of  simultaneous  processes. 


$J3  FALSE 


Effectively  give  each  process  an  infinite 
time-slice.  That  is,  let  a  process  execute 
until  it  becomes  blocked  or  until  it  finishes 
before  permitting  another  process  to  execute. 


$  W  TPFJE 

Continue  execut 
Execution  ceases 

$P  TRUE 

Print  process  st 

after  execution. 


(ii)  Toggles  used  for  tracing 


The  toggles  $T  and  $U  are  used  to  turn  tracing  on  and  off 
dynamically  during  interpretation.  The  remaining  toggles 
below  select  which  options  are  being  traced.  These  cannot  be 
changed  dynamically;  the  settings  at  the  end  of  compilation 
are  used. 


ST 


SO 


Turn  on  tracing  at  the  point  where  it  is 
encountered,  causing  trace  information 
selected  by  other  toggles  to  be  printed. 

Turn  off  tracing. 


$D2  FALSE  When  tracing,  dump  those  sections  of  the 

stack,  accessible  to  the  process  that  is 
executing,  after  each  instruction. 


Prior  to  each  interpreter  instruction 
executed,  print  one  line  specifying  the 
instruction,  address  and  process  (when  tracing 
is  on)  . 

When  tracing,  print  out  process  statistics  in 
each  dump. 

Print  a  line  giving  information  about 
resources  released  and  requested. 

Print  trace  of  string  usage  when  tracing. 

Print  trace  of  process  scheduling. 

Trace  returns  from  subroutines  when  tracing. 

toggles  are  not  available  in  the  short 

interpreter . 

These  toggles  are  abbreviated  in  the  short  interpreter. 

If  both  $1  and  $J  are  in  effect,  then  the  infinite  time 
slicing  is  taken.  If  neither  is  in  effect,  then  a  large, 
more  random  time  slice  is  used.  Instruction-by¬ 
instruction  time  slicing  is  very  expensive  in  terms  of 
CPU  time  and  should  be  used  with  care  and  only  with 
small  programs .. "Infinite"  time  slicing  results  in  the 
fastest  possible  execution  of  processes.  Use  of  the  $J 
option  can  greatly  reduce  the  cost  of  running  TOPPS 
"toy"  operating  systems.* 


$X  FALSE 

$  Y  FALSE 

$1i  FALSE 

$2 1  FALSE 
S31  FALSE 
$  R  FALSE 
1  These 


. 
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APPENDIX  D 

INTERPRETATION  OF  THE  STACK  DUMP 


The  TOPPS  dump  of  the  run  stack  is  printed  either 
when  a  job  abends  during  execution  with  error  code  greater 
than  0  or  when  the  $R  or  3D  toggles  are  on  {remember  3?  must 
be  on  also) .  The  dump  presents  those  segments  of  the  cactus 
stack  accessible  to  the  currently  active  process. 

There  are  two  forms  of  the  TOPPS  dump  --  a  long 
dump  in  the  150K  interpreter  and  a  short  dump  in  the  13QK 
interpreter.  In  the  long  dump  all  numbers  are  printed  in 
decimal  whereas  in  the  shorter  dump  the  run  stack  is  printed 
out  in  hexadecimal. 

Stack  segments  are  formed  whenever  a  declaration 
block,  a  program,  or  a  subprogram  is  entered.  The  first 
segment  is  for  the  currently  active  program  block.  The 
bottom  three  locations  of  the  segment  form  a  base  containing 
relevant  information  for  that  segment  (see  BASE  below). 
Above  the  base  are  the  descriptors  for  each  element  declared 
within  that  block,  program  or  subprogram.  By  examining  the 
lexic  level  and  order  number  of  a  variable  from  the  symbol 
table  dump,  one  can  then  find  the  location  of  that  variable 
in  the  stack  dump  and  its  corresponding  value.  Locations 
above  the  descriptors  are  for  expression  evaluation. 

The  run  stack  (RS)  is  four  bytes  wide.  Beside  it 
are  printed  the  attributes  from  the  attribute  stack  (ATS). 
The  meaning  of  the  RS  entries  vary  according  to  the  ATS 
entries  as  follows: 

0  RE FEE 


The  SS  entry  contains  a  reference  (address) 
pointing  to  another  location  in  the  RS, 

1  UNDER 


The  variable  declared  is  undefined.  The  RS  entry 
is  meaningless. 

2  ARRAY 


The  RS  entry  contains  an  array  descriptor. 

#  of  address  in  RS  of  address  in  RS  of 

dimensions  bounds  segment  array  storage 

segment 


4  b  its 


1 4  bits 


14  bits 


' 


- 


The 


P.S  entry 

segment  size 
(log  base  2 
less  2) 


contains  a  subprogram  descriptor, 

base  of  segment  in  entry  point 

which  declared  in  code 


2  bits 


14  bits 


16  bits 


4  NIP  BR 

The  PS  entry  contains  a  number. 

5  STSNG 


The  PS  entry  contains  the  address  into  the  string 
area  of  the  string.  The  long  dump  prints  ths  string  to  the 
right  of  the  PS. 

6  ARREF 

The  RS  entry  contains  the  address  in  array  storage 
of  the  array  element, 

7  P  BASE 


when  a  subprogram  is  called,  this  reference  to  the 


descriptor  of 
the  RS. 

the  subprogram 

that  was 

called  is 

placed  on 

0  BASE 

This 

locations  of 

at  tri bu te 
a  RS  segment. 

applies 

to  the  bottom  three 

BASE 

RET_ADDR 

S_R5_PTR 

BASE 

DYN  PTR 

STAT_PTR 

BASE 

SEG_TYPE 

S_LL 

CUT 

SIZE 

8  bits 

8  bits 

8  bits 

8  bits 

SEG_T YPE 
S_LL 
C  NT 


ST  ZE 
DYN  PTR 


attribute  code  of  segment 
lexic  level  of  this  segment 

number  of  processes  using  the  declarations  of 
this  segment 

log  base  2  of  size  of  segment 

address  of  base  of  dynamically  enclosing 
seg  men t 


- 


. 


' 
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STAT  PTR 


RET  AD DP 


S  PS  PTR 


address  of  first  segment  below  this  segment  in 
the  stack  whose  lexic  level  is  one  less  than 
that  of  this  segment. 

return  address  in  CODE  to  which  subprogram 
returns  if  SEG_TYPE  is  SPROG  or  the  process 
index  of  SE G_? YPE  is  PROG. 

temporary  storage*  for  run  stack  pointer  for 
this  segment. 


9  PROG 

The  RS  entry  is  a  program  descriptor  with  the  same 
format  as  for  the  SPROG. 


10  BLOCK 


Used  in  SEC-_TYPE  (i.e.,  for  declaration  blocks). 

11  CONSU 

The  RS  entry  contains  an  index  into  the  consumable 
resource  area.  In  the  long  dump  the  next  available  unit,  or 
1  NO  AVAILABLE  UNITS1  if  there  are  none,  is  printed. 


12  RE USA 


The  RS  entry  contains  a  pointer  into  the  resuable 
resource  area.  In  the  long  dump  a  message  stating  whether  or 
not  resource  units  are  available  is  printed. 

13  3LTIN 

The  RS  entry  contains  the  number  of  the  builtin 

f  unction . 


' 


■■ 


■ 
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APPE-IDIX  E 

I MPLE MENTATION  RESTRICT  IONS 

The  following  are  restrictions  as  of  August,  1973. 


1  .  Code  area 

2.  Run  stack 

large  interpreter 
small  interpreter 

20K  bytes 

8192  words 

6144  words 

3.  String  area 

250  descriptors 

4.  No.  of  consumable  resources 

32 

5.  No.  of  reusable  resources 

32 

6.  No.  of  consumable  resource  units 
(for  all  consumable  resources) 

512 

7.  No.  of  reusable  resource  units 

32 

8.  Symbol  table 

400  entries 

(includes  identifiers  declared  at  all  levels) 

9.  Maximum  number  of  declarations  per  block 
of  variables,  arrays,  subprograms,  and 


programs 


32 


. 

9  4 


APPENDIX  F 
PROGRAM  EXAMPLES 
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